提交任务：为商品生成背景（自动版）

POST

open.nolibox.com/api/aigc/product-background/generate-auto

接口介绍

输入原始商品图和风格场景，本 api 将输出商品换背景结果。

<img src=https://api.apifox.com/api/v1/projects/3638100/resources/410826/image-preview width=48%>

<img src=https://api.apifox.com/api/v1/projects/3638100/resources/410827/image-preview width=48%>

接口原理

输入原始商品图 fg_url（注：商品图无需提前完成抠图操作，接口内会自动抠图）；
指定画布的宽高尺寸output_w和output_h（即为输出结果的宽高尺寸，支持自定义输入数值，但接口在宽800×高800和宽750×高1000两种尺寸下表现较稳定，因此建议输入这两种尺寸）；
本 api 将根据商品的大小、形状，自动地将商品摆放到指定宽高的画布中；
指定背景主题 theme，应传入场景的alias，可在「查询商品图风格场景列表」接口中获取；
输入商品描述（英文），非必填项，接口会对商品图做识别，但如有准确的商品信息则建议输入给接口，这将会比 AI 识别得准确，也有助于生成更符合逻辑的结果；
POST 任务，返回值中可获取该任务的 uid；
在「查询商品换背景任务结果」中，根据 uid 查询任务结果。

计费逻辑

积分用户每成功使用 1 次该接口，将在剩余积分中扣除 8 积分
专机用户每成功使用 1 次该接口，将在剩余次数中扣除 1 次对应功能次数

请求参数

Header 参数

Body 参数application/json

示例

{
    "fg_url": "string",
    "scene_alias": "string",
    "output_w": 800,
    "output_h": 800,
    "product_description": "string",
    "notify_url": "string"
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'open.nolibox.com/api/aigc/product-background/generate-auto' \
--header 'Authorization: Basic xxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "fg_url": "string",
    "scene_alias": "string",
    "output_w": 800,
    "output_h": 800,
    "product_description": "string",
    "notify_url": "string"
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "code": 0,
    "msg": "string",
    "data": {
        "uid": "string"
    }
}

修改于 2024-02-02 01:14:24

查询商品图风格场景列表

查询商品换背景任务结果