Generate an image (Doubao native)

Generate images synchronously in Volcengine Ark format. There is no task to
poll; the complete result is returned in one response.

Point your client's base URL at https://<gateway-host>/doubao/api/v3 to
keep using Ark field names unchanged.

Text to image, image to image, or multi-image fusion?

The image field decides, and nothing else does:

Scenario	`image`
Text to image	omit it
Single-image edit	a string URL or `data:` URI
Multi-image fusion	an array of strings

Size

Two forms, pick one:

A preset keyword: 1K, 1.5K, or 2K.

Explicit pixels as widthxheight, for example 2048x2048. Width and
height must stay within 1024x1024 to 4096x4096 pixels with an aspect
ratio between 1:16 and 16:1.

Gateway behaviour that differs from Ark

Field	Ark	This gateway
`stream`	SSE streaming	Not supported. Send `false` or omit it.
`response_format`	`url` or `b64_json`	`url` only. Base64 output is not served on this route.
Other native fields	-	Forwarded unchanged, so new Ark parameters work without a gateway upgrade.

Use POST /v1/images/generations if you need b64_json.

application/json

Images generated.

Bodyapplication/json

示例

One imageGroup generation resultLayer decomposition result

{
    "data": [
        {
            "url": "https://ark-content-generation-v2-cn-beijing.tos-cn-beijing.volces.com/seedream/xxx.jpeg",
            "size": "2048x2048",
            "output_format": "jpeg"
        }
    ],
    "created": 1757469067,
    "usage": {
        "generated_images": 1,
        "output_tokens": 15908,
        "total_tokens": 15908
    }
}

Generate an image (Doubao native)

请求参数

请求示例代码

返回响应