seedream-v4-图生图

POST

/openapi/v2/seedream-v4/image-to-image

字节跳动专为高精度图像编辑打造的专业级模型。它擅长在保持主体身份、原有光影及构图完全一致的前提下，对局部元素进行精准重构。无论是人像摄影中的服装与妆造切换、电商产品的材质与配色更替，还是室内设计中的墙面与家具饰面翻新，Seedream 4.0 都能呈现出极高的还原度。模型对皮肤质感、织物细节及品牌 Logo 的处理尤为出色，能够确保多版本生成的工业级一致性。凭借结构化的提示词指令，它已成为品牌营销、电商测款及人像工作流中不可或缺的效能工具。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "prompt": "[动作：更换服装] 针对 [对象：参考图中的女性模特]，将其服装替换为 [目标特征：一件带有精致金色刺绣的高级祖母绿丝绸晚礼服]。[约束：保持主体身份、面部特征、皮肤纹理以及原有的柔和摄影棚光影布局完全一致]。确保布料的垂坠感和光泽度达到照片级写实，边缘细腻。",
    "width": 2048,
    "height": 2048,
    "imageUrls": [
        "https://www.runninghub.cn/view?filename=66cc3d5a608ebb6b4a808cb391f180a3475910024c68c2f71e530ddb1a4d7685.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NjkzOTk5NjkxODEsInRzIjoxNzY4Nzk1MTY5MTgxLCJzaWduIjoiZGI0ODg1NWIzNTQ2ZmZhNTliMWVkOTFlNjIxNTk5OTEifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.7075278267504961"
    ],
    "sequentialImageGeneration": "disabled",
    "maxImages": 1
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.runninghub.cn/openapi/v2/seedream-v4/image-to-image' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Authorization: Bearer [Your API KEY]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "prompt": "[动作：更换服装] 针对 [对象：参考图中的女性模特]，将其服装替换为 [目标特征：一件带有精致金色刺绣的高级祖母绿丝绸晚礼服]。[约束：保持主体身份、面部特征、皮肤纹理以及原有的柔和摄影棚光影布局完全一致]。确保布料的垂坠感和光泽度达到照片级写实，边缘细腻。",
    "width": 2048,
    "height": 2048,
    "imageUrls": [
        "https://www.runninghub.cn/view?filename=66cc3d5a608ebb6b4a808cb391f180a3475910024c68c2f71e530ddb1a4d7685.jpg&type=input&subfolder=&Rh-Comfy-Auth=eyJ1c2VySWQiOiIzZjY1MTNlNWEwNjY1N2I4OGYyNjU5NTEzYmU3ZDM0YyIsInNpZ25FeHBpcmUiOjE3NjkzOTk5NjkxODEsInRzIjoxNzY4Nzk1MTY5MTgxLCJzaWduIjoiZGI0ODg1NWIzNTQ2ZmZhNTliMWVkOTFlNjIxNTk5OTEifQ==&Rh-Identify=3f6513e5a06657b88f2659513be7d34c&rand=0.7075278267504961"
    ],
    "sequentialImageGeneration": "disabled",
    "maxImages": 1
}'

返回响应

🟢200成功

application/json

任务结果查询接口：/openapi/v2/query

Body

示例

提交任务响应示例任务完成（查询状态接口）响应示例

{
    "taskId": "2013508786110730241",
    "status": "RUNNING",
    "errorCode": "",
    "errorMessage": "",
    "results": null,
    "clientId": "f828b9af25161bc066ef152db7b29ccc",
    "promptTips": "{\"result\": true, \"error\": null, \"outputs_to_execute\": [\"4\"], \"node_errors\": {}}"
}

修改于 2026-03-11 12:00:02

seedream-v4.5-图生图

seedream-v5-lite-图生图