Image GenerationSeedream
Seedream 3
Text-to-image generation with native high-resolution (2K) support by ByteDance.
POST /v2/images/generate — model: "seedream-3"
A text-to-image model with support for native high-resolution (2K) image generation. Seedream 3 offers configurable guidance scale for controlling prompt adherence and multiple size presets.
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 in "W:H" format (e.g. "16:9"). Set to "custom" to use width/height |
seedreamParams.seed | integer | Random seed for reproducible generation |
seedreamParams.size | string | "regular" (1MP, default), "big" (2048px longest), or "small" (512px shortest). Ignored if aspect_ratio is "custom" |
seedreamParams.width | integer | Image width (512–2048). Only used when aspect_ratio is "custom" |
seedreamParams.height | integer | Image height (512–2048). Only used when aspect_ratio is "custom" |
seedreamParams.guidance_scale | number | Prompt adherence (1–10, default 2.5). Higher = more literal |
Credit cost
| Credits per generation |
|---|
| 3 |
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": "a serene Japanese garden with cherry blossoms in spring",
"model": "seedream-3",
"seedreamParams": {
"aspect_ratio": "16:9",
"size": "big"
}
}'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": "a serene Japanese garden with cherry blossoms in spring",
"model": "seedream-3",
"seedreamParams": {
"aspect_ratio": "16:9",
"size": "big",
},
},
)
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: "a serene Japanese garden with cherry blossoms in spring",
model: "seedream-3",
seedreamParams: { aspect_ratio: "16:9", size: "big" },
}),
});
console.log(await response.json());Try it
POST
/v2/images/generateTry it