POST /v1/images/edits

Method: POSTEndpoint: /v1/images/edits

Request Parameters

Header Parameters

Authorization
string
Optional
Default Value:
Bearer {{YOUR_API_KEY}}

Body Parameters multipart/form-data

model
string
Required
Example:
doubao-seedream-4-0-250828
image
file
Required
Example:
cmMtdXBsb2FkLTE2ODc4MzMzNDc3NTEtMjA=/31225951_59371037e9_small.png
mask
string
Optional
prompt
string
Required
Example:
A cute baby sea otter wearing a beret.
n
string
Optional
Example:
1
size
string
Optional
Example:
1024x1024
response_format
string
Optional
Example:
url

Example Request

Shell

curl --location --request POST '/v1/images/edits' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--form 'model="doubao-seedream-4-0-250828"' \
--form 'image=@"cmMtdXBsb2FkLTE2ODc4MzMzNDc3NTEtMjA=/31225951_59371037e9_small.png"' \
--form 'mask=""' \
--form 'prompt="A cute baby sea otter wearing a beret."' \
--form 'n="1"' \
--form 'size="1024x1024"' \
--form 'response_format="url"'

Response

🟢 200 Success

Content Type: application/json

Response Schema

object

Example

{
    "data": [
        {
            "url": "https://ark-content-generation-v2-cn-beijing.tos-cn-beijing.volces.com/doubao-seedream-4-0/021758199935261f8c6a85cf57ff2d1ecf10d9f546f1158255386_0.jpeg?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20250918%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20250918T125341Z&X-Tos-Expires=86400&X-Tos-Signature=dffc83ae6623fee4120bb06983d468a44bcc9a11517b62e2e70a1cca6eceaf77&X-Tos-SignedHeaders=host"
        },
        {
            "url": "https://ark-content-generation-v2-cn-beijing.tos-cn-beijing.volces.com/doubao-seedream-4-0/021758199935261f8c6a85cf57ff2d1ecf10d9f546f1158255386_1.jpeg?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20250918%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20250918T125342Z&X-Tos-Expires=86400&X-Tos-Signature=49dbf3d03e33ba0120ea415945795dccad2eb9c154b2b651a359f520c3c8c11d&X-Tos-SignedHeaders=host"
        },
        {
            "url": "https://ark-content-generation-v2-cn-beijing.tos-cn-beijing.volces.com/doubao-seedream-4-0/021758199935261f8c6a85cf57ff2d1ecf10d9f546f1158255386_2.jpeg?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20250918%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20250918T125343Z&X-Tos-Expires=86400&X-Tos-Signature=355adf061895c236cfa83cd945cdeb267ecc5d2a95b5c7290a8dd53c5f7a93d7&X-Tos-SignedHeaders=host"
        }
    ],
    "created": 1758200023,
    "usage": {
        "prompt_tokens": 0,
        "completion_tokens": 0,
        "total_tokens": 53400,
        "prompt_tokens_details": {
            "cached_tokens_details": {}
        },
        "completion_tokens_details": {},
        "output_tokens": 53400
    }
}