seedream-v4/image-to-image

POST

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

It excels at swapping outfits, adjusting makeup, and re-materializing products while maintaining perfect subject identity, lighting, and composition. The model delivers exceptional fidelity for human skin tones, fabric textures, and intricate brand logos, making it ideal for high-end e-commerce and influencer workflows. By utilizing structured prompts, Seedream 4.0 ensures production-ready consistency across multiple variants, empowering creative teams to execute rapid A/B testing and marketing campaigns with professional-grade visual accuracy and efficiency.

Request

Authorization

Header Params

Body Params application/jsonRequired

Example

{
    "prompt": "[Action: Swap outfit] on the [Object: female model in the reference image] to a [Target feature: premium emerald green silk evening gown with intricate gold embroidery]. [Constraints: Maintain exact subject identity, facial features, skin texture, and the original soft studio lighting setup]. Ensure the fabric draping and sheen are photorealistic with fine edges.",
    "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
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.runninghub.ai/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": "[Action: Swap outfit] on the [Object: female model in the reference image] to a [Target feature: premium emerald green silk evening gown with intricate gold embroidery]. [Constraints: Maintain exact subject identity, facial features, skin texture, and the original soft studio lighting setup]. Ensure the fabric draping and sheen are photorealistic with fine edges.",
    "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
}'

Responses

🟢200成功

application/json

Task result query endpoint: /openapi/v2/query

Body

Examples

Submit response exampleTask success response example

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

Modified at 2026-03-11 12:00:02

seedream-v4.5/image-to-image

seedream-v5-lite/image-to-image