图像编辑（OpenAI 兼容）

POST

/v1/images/edits

兼容 OpenAI Images API 的图像编辑接口，与
POST /v1/images/generations 相同，但必须提供至少一张参考图。

用 multipart/form-data 上传源图文件，或用 JSON 把 image 设为 URL
或 data: URI。

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

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

Body 参数

application/json

必填

示例

上传文件用 URL 引用多张参考图

{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "把这张照片改成夜景，增加霓虹灯氛围",
    "image": "@portrait.png",
    "size": "2K"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

上传文件用 URL 引用多张参考图

curl --location '/v1/images/edits' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "把这张照片改成夜景，增加霓虹灯氛围",
    "image": "@portrait.png",
    "size": "2K"
}'

返回响应

🟢200

application/json

生成成功。

Bodyapplication/json

示例

上传文件的编辑结果URL 引用的编辑结果两张参考图融合的结果

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

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

图像生成（OpenAI 兼容）

素材库管理（豆包原生）