图像生成（OpenAI 兼容）

POST

/v1/images/generations

兼容 OpenAI Images API 的图像生成接口。

请求体、响应体与计费都与 POST /doubao/api/v3/images/generations
相同，区别仅在路径与 response_format 的可用取值。

客户端已按 OpenAI Images API 编写时使用本路径。

与原生路径的差异：

支持 response_format: b64_json，网关会下载生成的图片并内联返回。

支持 multipart/form-data，参考图可以上传文件而不必用 URL。

n 必须为 1；需要多张请用 sequential_image_generation。

参数说明请参考原生路径。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

文生图单图编辑内联 Base64 输出

{
    "model": "doubao-seedream-5-0-flash-260915",
    "prompt": "赛博朋克风格的城市夜景，雨后湿滑的街道反射霓虹灯",
    "size": "2K"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

文生图单图编辑内联 Base64 输出

curl --location '/v1/images/generations' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedream-5-0-flash-260915",
    "prompt": "赛博朋克风格的城市夜景，雨后湿滑的街道反射霓虹灯",
    "size": "2K"
}'

返回响应

🟢200

application/json

生成成功。

Bodyapplication/json

示例

单张输出，URL单张编辑结果内联 Base64

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

🟠400BadRequest

🟠401Unauthorized

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

图像生成（豆包原生）

图像编辑（OpenAI 兼容）