Product ImageReplace V3 Submission

POST

/topview/v3/product_avatar/task/image_replace/submit

Product ImageReplace is an interface for intelligent replacement of product digital human image commodity pictures provided by the Topview platform. It supports users to replace specified commodity pictures with template pictures and automatically generate new product digital human images. It is widely used in scenarios such as e-commerce display and marketing content.
Example Picture
Price: 0.25 PTC/piece

Request

Header Params

Body Params application/json

Example

{
    "generateImageMode": "auto",
    "templateImageFileId": "c62216b7e35e4e8598edc29a4041c7b6",
    "productImageWithoutBackgroundFileId": "722e4c0ebdc148e295df9fe30c3160bd",
    "imageEditPrompt": "Replace the item in the hand of the person in Picture 1 with the one in Picture 2. Keep the composition position and gesture of the person in Picture 1 unchanged, and ensure that the features, appearance and details of the item in Picture 2 remain exactly the same after the change."
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.302.ai/topview/v3/product_avatar/task/image_replace/submit' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "generateImageMode": "auto",
    "templateImageFileId": "c62216b7e35e4e8598edc29a4041c7b6",
    "productImageWithoutBackgroundFileId": "722e4c0ebdc148e295df9fe30c3160bd",
    "imageEditPrompt": "Replace the item in the hand of the person in Picture 1 with the one in Picture 2. Keep the composition position and gesture of the person in Picture 1 unchanged, and ensure that the features, appearance and details of the item in Picture 2 remain exactly the same after the change."
}'

Responses

🟢200success

application/json

Body

Example

{
    "code": "200",
    "message": "Success",
    "result": {
        "taskId": "e3a3f7934f3644c3be4e044dc1c715b7",
        "status": "success",
        "errorMsg": null,
        "subTaskId": "e3a3f7934f3644c3be4e044dc1c715b7"
    }
}

Modified at 2025-12-10 03:55:25

productAnyShoot ReplaceImage Query

Product ImageReplace V3 Query