Seedream 5.0 Flash
Create an image task with this model, then query its result using the returned task ID.
Model ID seedream-5.0-flash
Quickstart
Create an and set I2V_API_KEY. Set IDEMPOTENCY_KEY once for each new task. Reuse the key and identical payload when retrying that submission.
Submit a task
POST https://api.i2v.ai/api/v1/jobs/createTask
curl "https://api.i2v.ai/api/v1/jobs/createTask" \
-H "Authorization: Bearer $I2V_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "seedream-5.0-flash",
"inputs": {
"prompt": "A calm lake at sunrise",
"resolution": "2K",
"aspectRatio": "1:1"
}
}'HTTP 200 means the task was accepted. Save the returned taskId.
{"taskId":"YOUR_TASK_ID"}Query the result
curl "https://api.i2v.ai/api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID" \
-H "Authorization: Bearer $I2V_API_KEY"Replace YOUR_TASK_ID with the returned ID. Poll with backoff while the status is waiting or generating. Read output[].url on success, or inspect error on fail.
Parameters
Send model inputs inside inputs. Media URLs must be publicly accessible. Required media and supported combinations depend on the selected generation mode.
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
inputs.prompt | string | Yes | — | Image prompt, or the edit instruction when reference images are attached. Maximum 5000 characters. |
inputs.resolution | string | No | 2K | Output tier: 1K or 2K. Allowed 1K, 2K. |
inputs.aspectRatio | string | No | 1:1 | Output aspect ratio; 21:9 is supported for wide compositions. Allowed 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9. |

