SEseedance2ai
Image

Generate images with Seedream 5 Pro

channel "economy" balances quality and cost; "standard" has fewer content restrictions and costs more. Each reference image in image_urls adds 1 credit.

post/api/v1/image/seedream-5-pro

Request

Headers

Idempotency-Keystring

Strongly recommended on every POST. Once a request has created (and charged for) a task, a retry with the same key and the same body within 24 hours replays that response instead of creating a second paid task. Errors raised before anything was charged, such as insufficient_credits or service_busy, are not replayed, so after fixing the cause the same key runs the request again. Reusing a key with a different body, or while the first request is still running, returns idempotency_conflict (HTTP 409). Surrounding whitespace is trimmed; keys longer than 120 characters are ignored, which disables the protection.

Request body

OR

Response

Task accepted. Poll GET /api/v1/tasks/{id} with the returned id (prefix sd5p_) until status is completed or failed, and read the files from result_urls there.

idstring required
status'processing' | 'completed' required

Usually processing. A channel that waits for the image inside the request returns completed; the task's result_urls are then ready at GET /api/v1/tasks/{id}.

model'seedream-5-pro' required
credits_usednumber

Credits charged for this task.

remaining_creditsnumber

Changes

No recorded changes to this operation across all 1 revision of this API.