doubao-seedream-4-0-250828-文生图

POST

/v1/images/generations

Given a prompt and/or an input image, the model will generate a new image.

Related guide: Image Generation

Create an image based on the prompts.

Request

Header Params

Body Params application/json

Example

{
"model": "doubao-seedream-4-0-250828",
"prompt": "Interstellar travel, black holes, a retro train bursting out of a black hole, visually striking, blockbuster, apocalyptic feel, dynamic, contrasting colors, OC rendering, ray tracing, motion blur, depth of field, surrealism, deep blue. The image uses delicate and rich color layers to shape the subject and scene, with realistic textures. The lighting effects in the dark background create an atmosphere, and the overall effect has an artistic fantasy feel. Exaggerated wide-angle perspective, glare, reflection, extreme light and shadow, strong gravity, swallowing."
"size": "1728x2304",
"sequential_image_generation": "disabled",
"stream": false,
"response_format": "url",
"watermark": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/images/generations' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
"model": "doubao-seedream-4-0-250828",
"prompt": "Interstellar travel, black holes, a retro train bursting out of a black hole, visually striking, blockbuster, apocalyptic feel, dynamic, contrasting colors, OC rendering, ray tracing, motion blur, depth of field, surrealism, deep blue. The image uses delicate and rich color layers to shape the subject and scene, with realistic textures. The lighting effects in the dark background create an atmosphere, and the overall effect has an artistic fantasy feel. Exaggerated wide-angle perspective, glare, reflection, extreme light and shadow, strong gravity, swallowing."
"size": "1728x2304",
"sequential_image_generation": "disabled",
"stream": false,
"response_format": "url",
"watermark": true
}'

Responses

🟢200success

application/json

Bodyapplication/json

Example

{
"data": [
{
"url": "https://ark-content-generation-v2-cn-beijing.tos-cn-beijing.volces.com/doubao-seedream-4-0/0217574690542070fa6ef8c2347680bd87fd8d357bb16f1e5ca0f_0.jpeg?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20250910%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20250910T015107Z&X-Tos-Expires=86400&X-Tos-Signature=fbc5369be594d6e21be983ed1ec32463b5f82cf0c18c4349e477c11e51e55fa0&X-Tos-SignedHeaders=host"
}
],
"created": 1757469067,
"usage": {
"prompt_tokens": 0,
"completion_tokens": 0,
"total_tokens": 15908,
"prompt_tokens_details": {
"cached_tokens_details": {}
},
"completion_tokens_details": {},
"output_tokens": 15908
}
}

Modified at 2026-09-23 08:28:57

doubao-seededit-3-0-i2i-250628

doubao-seedream-4-5-251128 Text-based image (plain text input, single image output)