Seedream Image Generation

this page Seedream image generation model, image model Endpoint, Parameters, constraints, responsesandExample.

Basic Information

Authentication

All /v1/* endpoints require an API key:

Authorization: Bearer <your_api_key>

supports Model

Public model	Capability	Billing basis
seedream-4.0	, image editing	image
seedream-4.5	, image editing	image
seedream-5.0-lite	, image editing	image

Model name supports andimage editing:

	OperationType
passreference
pass image/image_url/image_urls/images	image editing

billing detail recommended: image billing detail. custom_size, Landscape, Portrait, Ratio billing detail.

recommended

scenario	Endpoint	result	return
, synchronous	POST /v1/images/generations	Yes	data[].url
image editing, synchronous	POST /v1/images/edits	Yes	data[].url

Parameters

supported parameters

Parameters	Type		Required	Note
model	string	body	Yes	seedream-4.0, seedream-4.5, seedream-5.0-lite
prompt	string	body	Yes	oreditingprompt
n	integer	body	No	image,1 6. OpenAI compatibility field
custom_size	object	body	No	size,{"width": 2048, "height": 2048}
image	string / array	body / form	required for editing	reference URL, pass or
image_url	string / object / array	body / form	required for editing	reference URL, compatibility {"url": "..."}
image_urls	array	body / form	required for editing	multiple reference images URL
images	array	body	required for editing	multiple reference images URL, supportsstringorobject
timeout_seconds	integer	body	No	synchronousEndpoint

n

• defaultvalue: 1
• value: 1
• value: 6

Example:

{
  "num_images": 3
}

or:

{
  "n": 3
}

custom_size sizeRules

format:

{
  "custom_size": {
    "width": 2048,
    "height": 2048
  }
}

sizeconstraints:

Model				Whether 16
seedream-4.0	921600	16777216	4096	No
seedream-4.5	3686400	16777216	4096	No
seedream-5.0-lite	3686400	16777216	4096	No

size:

size	Ratio	seedream-4.0	seedream-4.5	seedream-5.0-lite
960x960	1:1		unavailable, below the minimum pixel size	unavailable, below the minimum pixel size
1280x720	16:9		unavailable, below the minimum pixel size	unavailable, below the minimum pixel size
720x1280	9:16		unavailable, below the minimum pixel size	unavailable, below the minimum pixel size
2048x2048	1:1
2560x1440	16:9
1440x2560	9:16
2304x1728	4:3
1728x2304	3:4
4096x4096	1:1	,	,	,

reference

image editingmode supports URL reference. does not support pass file.:

{
  "image": "https://example.com/a.png"
}

{
  "image_url": "https://example.com/a.png"
}

{
  "image_url": {
    "url": "https://example.com/a.png"
  }
}

{
  "image_urls": [
    "https://example.com/a.png",
    "https://example.com/b.png"
  ]
}

{
  "images": [
    "https://example.com/a.png",
    {
      "url": "https://example.com/b.png"
    },
    {
      "image_url": "https://example.com/c.png"
    }
  ]
}

editingconstraints:

constraints	value
reference up to	10
up to	6
+ up to	15

Example:

reference	num_images
1	6
5	6
9	6
10	5

synchronous

curl -X POST "$BASE_URL/v1/images/generations" \
 -H "Authorization: Bearer $API_KEY" \
 -H "Content-Type: application/json" \
 -d '{"model": "seedream-4.0",
 "prompt": "one, and "}'

responses:

{
  "created": 1778688000,
  "data": [
    {
      "url": "https://example.com/generated-1.png"
    }
  ]
}

generation 6

curl -X POST "$BASE_URL/v1/images/generations" \
 -H "Authorization: Bearer $API_KEY" \
 -H "Content-Type: application/json" \
 -d '{"model": "seedream-4.5",
 "prompt": ", ",
 "num_images": 6,
 "custom_size": {"width": 2048,
 "height": 2048}}'

16:9 Landscape

seedream-4.5 and seedream-5.0-lite, recommended 2560x1440:

curl -X POST "$BASE_URL/v1/images/generations" \
 -H "Authorization: Bearer $API_KEY" \
 -H "Content-Type: application/json" \
 -d '{"model": "seedream-5.0-lite",
 "prompt": "16:9, ",
 "n": 2,
 "custom_size": {"width": 2560,
 "height": 1440}}'

9:16 Portrait

curl -X POST "$BASE_URL/v1/images/generations" \
 -H "Authorization: Bearer $API_KEY" \
 -H "Content-Type: application/json" \
 -d '{"model": "seedream-4.5",
 "prompt": "Portrait, ",
 "num_images": 1,
 "custom_size": {"width": 1440,
 "height": 2560}}'

seedream-4.0 sizeExample

1280x720 seedream-4.0, seedream-4.5 and seedream-5.0-lite.

curl -X POST "$BASE_URL/v1/images/generations" \
 -H "Authorization: Bearer $API_KEY" \
 -H "Content-Type: application/json" \
 -d '{"model": "seedream-4.0",
 "prompt": "Landscape, ",
 "custom_size": {"width": 1280,
 "height": 720}}'

synchronousimage editing

JSON reference

curl -X POST "$BASE_URL/v1/images/edits" \
 -H "Authorization: Bearer $API_KEY" \
 -H "Content-Type: application/json" \
 -d '{"model": "seedream-4.0",
 "prompt": "change image into style, reserved subject ",
 "image": "https://example.com/source.png",
 "num_images": 1,
 "custom_size": {"width": 2048,
 "height": 2048}}'

JSON multiple reference images

curl -X POST "$BASE_URL/v1/images/edits" \
 -H "Authorization: Bearer $API_KEY" \
 -H "Content-Type: application/json" \
 -d '{"model": "seedream-4.5",
 "prompt": " reference, ",
 "image_urls": ["https://example.com/product.png",
 "https://example.com/background.png"],
 "n": 3,
 "custom_size": {"width": 2560,
 "height": 1440}}'

images arrayobject

curl -X POST "$BASE_URL/v1/images/edits" \
 -H "Authorization: Bearer $API_KEY" \
 -H "Content-Type: application/json" \
 -d '{"model": "seedream-5.0-lite",
 "prompt": "reference one and, generationone style ",
 "images": [{"url": "https://example.com/person.png"},
 {"image_url": "https://example.com/outfit.png"}],
 "num_images": 2,
 "custom_size": {"width": 2048,
 "height": 2048}}'