Image GenerationSeedream
Seedream 3.1
4MP cinematic-quality image generation with precise style control by ByteDance (Dreamina 3.1).
POST /v2/images/generate — model: "seedream-3.1"
Cinematic-quality image generation with precise style control, improved text rendering, and commercial design optimization. This model is also known as Dreamina 3.1.
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. "1:1"). Set to "custom" to use width/height |
seedreamParams.seed | integer | Random seed for reproducible generation |
seedreamParams.resolution | string | Image resolution quality. Default "2K" |
seedreamParams.use_pre_llm | boolean | Enable text expansion for better results with short prompts (default true) |
seedreamParams.width | integer | Image width (512–3024). Only used when aspect_ratio is "custom" |
seedreamParams.height | integer | Image height (512–3024). Only used when aspect_ratio is "custom" |
Credit cost
| Credits per generation |
|---|
| 4 |
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": "cinematic film still of a detective in a rain-soaked alley, noir lighting",
"model": "seedream-3.1",
"seedreamParams": {
"aspect_ratio": "16:9",
"resolution": "2K"
}
}'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": "cinematic film still of a detective in a rain-soaked alley, noir lighting",
"model": "seedream-3.1",
"seedreamParams": {
"aspect_ratio": "16:9",
"resolution": "2K",
},
},
)
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: "cinematic film still of a detective in a rain-soaked alley, noir lighting",
model: "seedream-3.1",
seedreamParams: { aspect_ratio: "16:9", resolution: "2K" },
}),
});
console.log(await response.json());Try it
POST
/v2/images/generateTry it