Edit an image (OpenAI compatible)

POST

/v1/images/edits

OpenAI Images API compatible image editing. Identical to
POST /v1/images/generations except that at least one reference image is
required.

Send multipart/form-data to upload the source images as files, or JSON with
image set to a URL or data: URI.

请求参数

Authorization

JWT Bearer

在 Header 添加参数

Authorization

示例：

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

Body 参数

application/json

必填

示例

Upload a fileReference by URLSeveral reference images

{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "Turn this photo into a night scene with neon lights",
    "image": "@portrait.png",
    "size": "2K"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Upload a fileReference by URLSeveral reference images

curl --location '/v1/images/edits' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "doubao-seedream-5-0-pro-260628",
    "prompt": "Turn this photo into a night scene with neon lights",
    "image": "@portrait.png",
    "size": "2K"
}'

返回响应

🟢200

application/json

Images generated.

Bodyapplication/json

示例

One edited image from the uploaded fileOne edited image from the URLOne fused image from both references

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

🟠400BadRequest

🟠401Unauthorized

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

Generate an image (OpenAI compatible)

Manage the asset library (Doubao native)