Image GenerationSeedream
Seedream 5.0 Pro
ByteDance's flagship text-to-image and editing model with sharp 1K/2K output and up to 10 reference images.
POST /v2/images/generate — model: "seedream-5-pro"
ByteDance's flagship Seedream model. Generates sharp 1K and 2K images from text or up to 10 reference images, with advanced prompt reasoning, precision editing, and native multilingual text rendering across 14 languages.
See Image Generation overview for common request fields, response format, and error codes.
Model-specific parameters
| Parameter | Type | Description |
|---|---|---|
seedreamParams.aspect_ratio | string | Aspect ratio. Use "match_input_image" to match the first reference image, or "W:H" format (e.g. "16:9", "21:9") |
seedreamParams.size | string | "1K" or "2K" (default) |
seedreamParams.image_input | string[] | Up to 10 reference image URLs for image-to-image generation or multi-reference editing |
seedreamParams.output_format | string | "png" (default) or "jpg" |
seedreamParams.seed | integer | Seed for reproducible results |
Credit cost
| Resolution | Credits |
|---|---|
| 1K | 9 |
| 2K | 18 |
Example result
Once the job is COMPLETED, the result object on GET /v2/jobs/:id looks like:
{
"images": [
"https://cdn2.apiframe.ai/images/a1b2c3d4-e5f6-7890-abcd-ef1234567890-1.png"
]
}See Result format for field details.
Code examples
curl -X POST https://api.apiframe.ai/v2/images/generate \
-H "X-API-Key: afk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"prompt": "an editorial infographic poster explaining the water cycle, clean typography, isometric icons",
"model": "seedream-5-pro",
"seedreamParams": {
"size": "2K",
"aspect_ratio": "3:4",
"output_format": "png"
}
}'import requests
response = requests.post(
"https://api.apiframe.ai/v2/images/generate",
headers={
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
json={
"prompt": "an editorial infographic poster explaining the water cycle, clean typography, isometric icons",
"model": "seedream-5-pro",
"seedreamParams": {
"size": "2K",
"aspect_ratio": "3:4",
"output_format": "png",
},
},
)
print(response.json())const response = await fetch("https://api.apiframe.ai/v2/images/generate", {
method: "POST",
headers: {
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
body: JSON.stringify({
prompt: "an editorial infographic poster explaining the water cycle, clean typography, isometric icons",
model: "seedream-5-pro",
seedreamParams: { size: "2K", aspect_ratio: "3:4", output_format: "png" },
}),
});
console.log(await response.json());With multi-reference editing
curl -X POST https://api.apiframe.ai/v2/images/generate \
-H "X-API-Key: afk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Place the product from image 1 into the studio scene from image 2, matching the lighting",
"model": "seedream-5-pro",
"seedreamParams": {
"image_input": [
"https://example.com/product.jpg",
"https://example.com/studio.jpg"
],
"size": "2K",
"aspect_ratio": "match_input_image"
}
}'import requests
response = requests.post(
"https://api.apiframe.ai/v2/images/generate",
headers={
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
json={
"prompt": "Place the product from image 1 into the studio scene from image 2, matching the lighting",
"model": "seedream-5-pro",
"seedreamParams": {
"image_input": [
"https://example.com/product.jpg",
"https://example.com/studio.jpg",
],
"size": "2K",
"aspect_ratio": "match_input_image",
},
},
)
print(response.json())Try it
POST
/v2/images/generateTry it