提交图像生成任务

POST

/v2/images/generations (seedream-5.0)

提交一个图像生成任务。任务创建成功后立即返回任务 ID（task_id），
实际生成在后台进行，请通过 GET /v2/tasks/{task_id} 查询结果。

是否传入参考图（image_urls）决定生成模式：

不传：文生图，根据 prompt 文字描述生成新图。

传 1~9 张：图生图 / 多图融合。

配合 sequential_image_generation=auto 可开启组图模式，生成一组内容关联的图片。

参数要求：

model 必填。

文生图模式下 prompt 必填。

n 取值范围 1~10。

size 支持档位（2K/4K）或像素（2048x2048）两种写法，默认 2K。

image_urls 最多 9 张，支持 base64（data:image/...;base64,...）或图片 URL。

请求参数

Authorization

Header 参数

Body 参数application/json必填

示例

文生图 - 基线文生图 - 完整参数文生组图 - 生成一组关联图片图生图 - 单图改图（base64 风格迁移）图生图 - 单图链接模式多图融合 - 虚拟试穿（2 张参考图）多参考图组图 - 基于多张参考图生成组图联网搜索 - 生成时效性图片

{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "一只赛博朋克风格的橘猫，霓虹光效",
    "size": "2K"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

curl --location '/v2/images/generations    (seedream-5.0)' \
--header 'Accept;' \
--header 'Content-Type: application/json' \
--data '{
    "model": "doubao-seedream-5-0-260128",
    "prompt": "一只赛博朋克风格的橘猫，霓虹光效",
    "size": "2K"
}'

返回响应

🟢200

application/json

任务创建成功，已进入排队。

Bodyapplication/json

示例

{
    "id": "task_c8FQYX2jkwwYxvuzjZCii5re3eycMx82",
    "model": "doubao-seedream-5-0-260128",
    "status": "QUEUED",
    "created_at": 1784800359,
    "metadata": {
        "source": "my-app"
    }
}

🟠401

🟠429

🔴503

修改于 2026-07-27 08:34:42

OpenAI聊天格式

查询任务结果