即梦4 绘图

方法: POST路径: /v1/images/generations

支持多图参考

请求参数

Header 参数

Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}

Body 参数 application/json

model
string
必需
prompt
string
必需
image
array
[string]
不带就是文生图
可选
n
string
组图
可选
sequential_image_generation
string
可选
response_format
string
可选
size
string
可选
stream
boolean
可选
watermark
boolean
可选
示例
{
"model"
:
"doubao-seedream-4-0-250828"
,
"prompt"
:
"生成3张女孩和奶牛玩偶在游乐园开心地坐过山车的图片，涵盖早晨、中午、晚上"
,
"image"
:
[
"https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_1.png"
,
"https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_2.png"
]
,
"sequential_image_generation"
:
"auto"
,
"n"
:
3
,
"response_format"
:
"url"
,
"size"
:
"2K"
,
"stream"
:
true
,
"watermark"
:
true
}

请求示例代码

Shell

curl --location --request POST '/v1/images/generations' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "model": "doubao-seedream-4-0-250828",
    "prompt": "生成3张女孩和奶牛玩偶在游乐园开心地坐过山车的图片，涵盖早晨、中午、晚上",
    "image": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_1.png",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_imagesToimages_2.png"
    ],
    "sequential_image_generation": "auto",
    "n": 3,
    "response_format": "url",
    "size": "2K",
    "stream": true,
    "watermark": true
}'

返回响应

🟢 200 成功

内容类型: application/json

响应结构

data
array
[object]
必需
url
string
可选
created
integer
必需
usage
object
必需
prompt_tokens
integer
必需
completion_tokens
integer
必需
total_tokens
integer
必需
prompt_tokens_details
object
必需
completion_tokens_details
object
必需
output_tokens
integer
必需

示例

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