productAnyShoot ReplaceImage Submit

Request

Header Params

Authorization

string

optional

Example:

Bearer {{YOUR_API_KEY}}

Body Params application/json

productImageFileId

string

required

Product image file ID

templateId

string

optional

Template Number

templateMaskFileId

string

required

Template mask fileId. [Must be consistent with the original image size] User generates it themselves

mode

string

optional

Mode. easy/advanced

generatingCount

integer

required

Generating Count. Supports 1 to 4

easyModePrompt

string

required

You are a professional software documentation translation expert.
Your task is to translate the given text into English.
Important rules:

1.

Preserve all original formatting, including Markdown tables, line breaks, code blocks, and spaces.

2.

Do not translate technical terms, API endpoints, parameter names, code snippets, or placeholders (such as '{VARIABLE}', 'true', 'null').

3.

Only translate human-readable descriptions and names.

4.

Return only the translated text, without any additional explanations or apologies.

productMaskFileId

string

optional

Product mask fileId. [Must be consistent with the original image size] If uploaded, the user needs to generate it themselves.

templateImageFileId

string

optional

Template image fileId. TemplateId and template image fileId cannot both be empty. If both templateId and template image fileId exist, templateImageFileId will take precedence over TemplateId.

Example

{
    "productImageFileId": "5d728d111b4c44dd819257a45102b403",
    "templateId": "5424c6dc28764687926ca62164d0a941",
    "templateMaskFileId": "5d728d111b4c44dd819257a45102b403",
    "mode": "easy",
    "generatingCount": 1,
    "easyModePrompt":"302"
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.302.ai/topview/v1/product_anyShoot/task/submit' \
--header 'Content-Type: application/json' \
--data-raw '{
    "productImageFileId": "5d728d111b4c44dd819257a45102b403",
    "templateId": "5424c6dc28764687926ca62164d0a941",
    "templateMaskFileId": "5d728d111b4c44dd819257a45102b403",
    "mode": "easy",
    "generatingCount": 1,
    "easyModePrompt":"302"
}'

Responses

🟢200成功

application/json

Body

code

string

required

message

string

required

result

object

required

taskId

string

required

status

string

required

errorMsg

null

required

subTaskId

string

required

Example

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