POST /v1/images/generations

Method: POSTEndpoint: /v1/images/generations

https://www.volcengine.com/docs/82379/1541523

Request Parameters

Header Parameters

Content-Type
string
Optional
Example:
application/json
Authorization
string
Optional
Default Value:
Bearer {{YOUR_API_KEY}}

Body Parameters application/json

model
string
Required
prompt
string
Required
response_format
string
Optional
size
string
Optional
seed
integer
Optional
guidance_scale
number
Optional
watermark
boolean
Optional
Example
{
"model"
:
"doubao-seedream-3-0-t2i-250415"
,
"prompt"
:
  // provider-specific example normalized for English documentation
,
"response_format"
:
"url"
,
"size"
:
"1024x1024"
,
"seed"
:
12
,
"guidance_scale"
:
2.5
,
"watermark"
:
true
}

Example Request

Shell

curl --location --request POST '/v1/images/generations' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "doubao-seedream-3-0-t2i-250415",
    "prompt": "Example prompt from provider documentation.",
    "response_format": "url",
    "size": "1024x1024",
    "seed": 12,
    "guidance_scale": 2.5,
    "watermark": true
}'

Response

🟢 200 Success

Content Type: application/json

Response Schema

object

Example

{
    "created": 1754449685,
    "data": [
        {
            "url": "https://p26-aiop-sign.byteimg.com/tos-cn-i-vuqhorh59i/20250806110805A18DC8771446299614A7-5091-0~tplv-vuqhorh59i-image.image?rk3s=7f9e702d&x-expires=1754536085&x-signature=ZCQAhwmg95HcBu8n8xau%2F4XWtO0%3D",
            "revised_prompt": "NONE"
        }
    ]
}