图像生成（豆包原生）

POST

/doubao/api/v3/images/generations

以火山方舟原生格式同步生成图像，没有任务需要轮询，一次响应返回全部结果。

把客户端 base_url 配成 https://<网关域名>/doubao/api/v3，
即可沿用方舟的字段名直接对接。

文生图、图生图还是多图融合？

只由 image 字段决定：

场景	`image`
文生图	不传
单图编辑	字符串 URL 或 `data:` URI
多图融合	字符串数组

尺寸

两种写法二选一：

档位关键字：1K、1.5K、2K。

具体像素 宽x高，如 2048x2048。宽高需在 1024x1024 到
4096x4096 像素之间，宽高比在 1:16 到 16:1 之间。

与方舟官方的差异

字段	方舟	本网关
`stream`	SSE 流式	不支持，请传 `false` 或不传
`response_format`	`url` 或 `b64_json`	仅 `url`，本路径不返回 Base64
其他原生字段	—	原样透传，上游新增参数无需网关升级

需要 b64_json 请使用 POST /v1/images/generations。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

Authorization: ********************

Body 参数application/json必填

{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "星空下的雪山湖泊，倒映着银河，写实摄影风格",
    "size": "2K"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/doubao/api/v3/images/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "星空下的雪山湖泊，倒映着银河，写实摄影风格",
    "size": "2K"
}'

返回响应

🟢200

application/json

生成成功。

Bodyapplication/json

示例

单张输出组图结果图层拆分结果

{
    "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
    }
}

🟠400

🟠401Unauthorized

🟠429RateLimited

修改于 2026-10-28 04:38:23

下载生成的视频文件

图像生成（OpenAI 兼容）