switch_heading

label llms.txt open_chatgpt
Seedream 5 Pro /v1/images

Image generation API

Generate new images from text or edit up to ten reference images with Seedream 5 Pro. One stable model alias, predictable product pricing, and provider-independent task responses.

Model alias

seedream-5-pro

Input modes

Text or references

Base price

9 / 18 credits

Quick start

Create a task, keep its task ID, then poll the status endpoint until it reaches SUCCESS or FAILED.

bash
1curl -X POST 'https://seedanceapi.org/v1/images/generations' \
2 -H 'Authorization: Bearer YOUR_API_KEY' \
3 -H 'Content-Type: application/json' \
4 -d '{
5 "model": "seedream-5-pro",
6 "prompt": "A cinematic product photo on a reflective surface",
7 "aspect_ratio": "1:1",
8 "resolution": "1k",
9 "image_urls": []
10 }'

Request lifecycle

  1. 01

    Authenticate

    Use an existing Seedance API key in the Bearer authorization header.

  2. 02

    Create a task

    Send the request once and keep the task ID returned by the API.

  3. 03

    Poll for results

    Query by task ID. Successful images resolve to our archived CDN URL.

Authentication

All image endpoints require your existing Seedance API key. Internal provider credentials are never exposed.

http
1Authorization: Bearer YOUR_API_KEY
2Content-Type: application/json

Pricing

Pricing is tied to the public product, not the provider route. The create response returns estimated_credits and a successful status returns consumed_credits.

ResolutionBase costAdditional references
1K9 credits+0.8 credits each from the second image
2K18 credits+0.8 credits each from the second image

Endpoints

POST/v1/images/generations

An empty image_urls array creates from text. One to ten URLs switches to reference-image editing.

Body ParametersJSON
model:string

Must be seedream-5-pro.

prompt:string

A text prompt or editing instruction, up to 3000 characters.

aspect_ratio:optional string

One of 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, or 3:2. Defaults to 1:1.

resolution:optional string

Use 1k or 2k. Defaults to 1k.

image_urls:optional string[]

Zero to ten public HTTPS image URLs. Empty means text-to-image.

Text-to-image request

json
1{
2 "model": "seedream-5-pro",
3 "prompt": "A cinematic product photo on a reflective surface",
4 "aspect_ratio": "1:1",
5 "resolution": "1k",
6 "image_urls": []
7}

Reference-image edit

json
1{
2 "model": "seedream-5-pro",
3 "prompt": "Place this product in a minimal studio scene",
4 "aspect_ratio": "4:3",
5 "resolution": "2k",
6 "image_urls": [
7 "https://cdn.example.com/reference.png"
8 ]
9}

HTTP 202

json
1{
2 "task_id": "n30c6f2...seed",
3 "status": "IN_PROGRESS",
4 "model": "seedream-5-pro",
5 "estimated_credits": 9
6}
GET/v1/images/generations/:task_id

Retrieve the latest task state using the task ID returned at creation time.

bash
1curl 'https://seedanceapi.org/v1/images/generations/n30c6f2...seed' \
2 -H 'Authorization: Bearer YOUR_API_KEY'

SUCCESS

json
1{
2 "task_id": "n30c6f2...seed",
3 "status": "SUCCESS",
4 "model": "seedream-5-pro",
5 "images": [
6 { "url": "https://cdn44.gogloai.com/results/image.png" }
7 ],
8 "consumed_credits": 9,
9 "created_at": "2026-07-13 10:00:00"
10}

FAILED

json
1{
2 "task_id": "n30c6f2...seed",
3 "status": "FAILED",
4 "model": "seedream-5-pro",
5 "consumed_credits": 0,
6 "error": {
7 "code": "GENERATION_FAILED",
8 "message": "Image generation failed."
9 }
10}

Errors

HTTPCodeMeaning
400INVALID_*Invalid JSON, model, prompt, ratio, resolution, URL, or image count.
401INVALID_API_KEYThe Bearer API key is missing or invalid.
402INSUFFICIENT_CREDITSThe API key does not have enough credits.
404TASK_NOT_FOUNDThe task was not found.
502 / 503UPSTREAM_*The upstream image service is unavailable or rejected task creation.