Seedream 5.0 API
Seedream 5.0 images from a prompt and reference pictures (up to 14), 2K or 3K quality. PNG or JPEG output.
For AI assistants:Download .mdAll documentation .mdOpen as text
Connect in three steps
- Get a keyCreate a key in the dashboard after you confirm your email. One key opens every model.
- Check the pricePOST /v1/price shows the cost of a run in advance, without charging you.
- Run a task and collect the resultPOST /v1/tasks starts a task, GET /v1/tasks/{id} shows its status and files.
Ready-to-use code
Replace YOUR_API_KEY with your key. The code starts a task and waits for the result. In cURL, repeat the second request with the id from the first response instead of TASK_ID until status becomes succeeded.
curl -X POST "https://api.cyhub.ai/v1/tasks" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "seedream",
"settings": {
"mode": "5.0",
"prompt": "Уютная кофейня дождливым вечером, тёплый свет в окнах",
"aspect_ratio": "3:4",
"quality": "3K",
"output_format": "png"
}
}'
curl "https://api.cyhub.ai/v1/tasks/TASK_ID" \
-H "Authorization: Bearer YOUR_API_KEY"import time
import requests
API = "https://api.cyhub.ai/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}
body = {
"model": "seedream",
"settings": {
"mode": "5.0",
"prompt": "Уютная кофейня дождливым вечером, тёплый свет в окнах",
"aspect_ratio": "3:4",
"quality": "3K",
"output_format": "png",
},
}
response = requests.post(f"{API}/tasks", json=body, headers=HEADERS, timeout=60)
response.raise_for_status()
task = response.json()
while task["status"] in ("queued", "running"):
time.sleep(5)
task = requests.get(f"{API}/tasks/{task['id']}", headers=HEADERS, timeout=30).json()
print(task["status"], task["result"])const API = "https://api.cyhub.ai/v1";
const HEADERS = { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" };
const body = {
"model": "seedream",
"settings": {
"mode": "5.0",
"prompt": "Уютная кофейня дождливым вечером, тёплый свет в окнах",
"aspect_ratio": "3:4",
"quality": "3K",
"output_format": "png"
}
};
async function main() {
let response = await fetch(`${API}/tasks`, { method: "POST", headers: HEADERS, body: JSON.stringify(body) });
if (!response.ok) throw new Error(await response.text());
let task = await response.json();
while (task.status === "queued" || task.status === "running") {
await new Promise((resolve) => setTimeout(resolve, 5000));
response = await fetch(`${API}/tasks/${task.id}`, { headers: HEADERS });
task = await response.json();
}
console.log(task.status, task.result);
}
main();Price before the run
Prices as of 15.10.2026: from 8 ₽. POST /v1/price shows the exact price of your settings.
| Mode | Price |
|---|---|
| Seedream 5.0 | from 8 ₽ |
Send the same settings to POST /v1/price: the response shows the price of the run without charging you.
curl -X POST "https://api.cyhub.ai/v1/price" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "seedream",
"settings": {
"mode": "5.0",
"prompt": "Уютная кофейня дождливым вечером, тёплый свет в окнах",
"aspect_ratio": "3:4",
"quality": "3K",
"output_format": "png"
}
}'amount_minor: the price of the run in minor units (kopecks for rubles)currency: the wallet currencyavailable_minor: how much your balance has for new tasks right now
Seedream 5.0
2K or 3K quality, up to 14 references, PNG or JPEG result.
Value of the mode field: 5.0
Price in this mode from 8 ₽.
Parameters
Model parameters go inside settings. Omitted optional fields take their default values.
promptRequiredWhat to draw, or what to do with the reference images.
Type: StringMinimum characters: 1Maximum characters: 5000image_urlsOptionalReference image URLs, up to 14. Without them the image is drawn from the prompt alone.
Type: List (String, uri)Maximum items: 14aspect_ratioOptionalAspect ratio.
Type: StringAllowed values:1:12:33:23:44:39:1616:921:9Default:"9:16"qualityOptionalImage quality: 2K or 3K.
Type: StringAllowed values:2K3KDefault:"2K"output_formatOptionalResult file format.
Type: StringAllowed values:pngjpegDefault:"png"
Parameters not listed here are not accepted: the response is 422 unknown_setting.
The API sets these settings itself, do not send them: model_version = "5.0"
Input
- References are URLs of JPEG, PNG, WebP, BMP, TIFF or GIF images, up to 30 MB each.
- Each picture has both sides longer than 14 pixels, an area of at most 6000×6000 pixels, and one side at most 16 times longer than the other.
| Field | Accepts | Formats | Files | File size up to |
|---|---|---|---|---|
image_urls | Images | jpeg, jpg, png, webp, bmp, tiff, tif, gif | 14 | 30 MB |
Request example
Send this JSON to POST /v1/tasks with your API key. To check the price first, send the same JSON to POST /v1/price.
An image from a prompt
{
"model": "seedream",
"settings": {
"mode": "5.0",
"prompt": "Уютная кофейня дождливым вечером, тёплый свет в окнах",
"aspect_ratio": "3:4",
"quality": "3K",
"output_format": "png"
}
}The price is calculated when the task is accepted, currency RUB.
Output
- One image per run in the chosen format.
| Kind | Formats | How many | Note |
|---|---|---|---|
image | png, jpg | 1 | The format is set by output_format. |
A finished task as GET /v1/tasks/{id} returns it (some fields left out). The caption may sit on the task or on a single file and may be empty; the model picks the file name.
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": "succeeded",
"finished_at": "2026-10-01T12:03:41+00:00",
"result": {
"caption": "Caption of the result: the model and its settings",
"texts": [],
"files_expire_at": "2026-10-08T12:03:41+00:00",
"files_expired": false,
"artifacts": [
{
"index": 0,
"kind": "image",
"filename": "image.png",
"size": 1843200,
"caption": "",
"download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
}
]
}
}See also
Try Seedream 5.0 through the API
One key opens every CyHUB model. Payment in rubles, and you see the price before the run.
Get an API key