Seedream 5.5 API
Seedream 5.5 is the newest Seedream image model: t2i creates images from text and i2i edits or restyles 1–10 reference images, with transparent backgrounds, one image per request at 1k, 1.5k or 2k. seedream-v5.5 runs in China and dola-seedream-5.5 is the international version.
Capabilities
- Model
- Image
- API model
seedream-v5.5-i2i- Endpoints
- POST /v1/image/generations, GET /v1/image/generations/{id}
- Parameters
- prompt: 5–5000, images: 1–10 (i2i), metadata.resolution: 1k / 1.5k / 2k, metadata.width / metadata.height: 240–11520, 921,600–8,294,400 px, metadata.background: auto / transparent / opaque, metadata.output_format: jpeg / png, metadata.watermark
Current pricing
seedream-v5.5-i2i: ≈¥0.16–0.52 per request
Model variants
| API model | Use case | Current pricing |
|---|---|---|
seedream-v5.5-i2i | Image editing | ≈¥0.16–0.52 per request |
seedream-v5.5-t2i | Text to image | ≈¥0.12–0.20 per request |
Gallery examples
Arknights StyleAPI model:
seedream-v5.5-i2iArknights Style — explore this seedream-v5.5-i2i creation on OpenZhenZhen, with its original prompt and a reusable generation example.
Quick start
Example workflow: create a product cut-out with t2i (background: transparent with png), then switch to i2i and add images to change the backdrop or style. A prompt of 5–5000 characters is required; t2i accepts no references and i2i needs 1–10 (30 MB each at most). metadata.resolution is 1k, 1.5k or 2k (default 2k) and takes priority over width and height; alternatively send metadata.width and metadata.height (240–11520 each, 921,600–8,294,400 pixels in total, aspect ratio 1:16 to 16:1). background is auto, transparent or opaque, and transparent requires png; output_format is jpeg or png; watermark is a boolean. seed and n are not supported.
cURL
curl --fail-with-body https://www.zzai.app/v1/image/generations \
-H "Authorization: Bearer $SEEDANCE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"images":["https://your-cdn.example/reference.png"],"metadata":{"height":1152,"output_format":"jpeg","width":2048},"model":"seedream-v5.5-i2i","prompt":"Keep the product unchanged and replace the background with a light grey studio."}'Python
import json, os, requests
payload = json.loads(r'''{"images":["https://your-cdn.example/reference.png"],"metadata":{"height":1152,"output_format":"jpeg","width":2048},"model":"seedream-v5.5-i2i","prompt":"Keep the product unchanged and replace the background with a light grey studio."}''')
response = requests.post(
"https://www.zzai.app/v1/image/generations",
headers={"Authorization": "Bearer " + os.environ["SEEDANCE_API_KEY"]},
json=payload, timeout=120,
)
response.raise_for_status()
print(response.json()["id"])JavaScript
const response = await fetch("https://www.zzai.app/v1/image/generations", {
method: 'POST',
headers: { Authorization: 'Bearer ' + process.env.SEEDANCE_API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({"images":["https://your-cdn.example/reference.png"],"metadata":{"height":1152,"output_format":"jpeg","width":2048},"model":"seedream-v5.5-i2i","prompt":"Keep the product unchanged and replace the background with a light grey studio."}),
});
if (!response.ok) throw new Error(await response.text());
console.log((await response.json()).id);Save the returned id as TASK_ID in the query example. Query every 3–5 seconds until success or failure; submission does not mean generation is complete. Save result files promptly. data.status: SUCCESS / FAILURE; data.result_url.
curl --fail-with-body https://www.zzai.app/v1/image/generations/$TASK_ID \
-H "Authorization: Bearer $SEEDANCE_API_KEY"Frequently asked questions
How do I call this model?
Create an API key, choose the model name below, and send a request to the documented OpenAI-compatible endpoint. Final billing follows the current price and usage parameters.