图案提取 V1 - 超然POD

一次请求只创建一个图案提取 V1 任务，返回 task_id 后轮询查询。参数与网站端图案提取 V1 表单保持一致：图片输入、产品类型、图片比例、图片底色、抠图模式。图片输入可传 imageUrl 或 assetId。

本接口参数枚举：

input.productType=general：通用

input.productType=clock：挂钟

input.productType=mug：马克杯

input.productType=tshirt：T 恤

input.productType=round_tablecloth：圆形桌布

input.ratio=1:1：正方

input.ratio=2:3：竖幅

input.ratio=3:2：横幅

input.ratio=3:4：竖幅

input.ratio=4:3：横幅

input.ratio=4:5：竖幅

input.ratio=5:4：横幅

input.ratio=9:16：长图

input.ratio=16:9：横图

input.ratio=21:9：超宽

input.backgroundMode=transparent：透明底

input.backgroundMode=opaque：不透明

input.mattingMode=通用抠图：通用模式，适合简单图案抠图

input.mattingMode=高级抠图：高级模式，适合复杂印花图案抠图

请求参数

Header 参数

Body 参数application/json

示例

{
    "input": {
        "imageUrl": "https://example.com/input.png",
        "productType": "general",
        "ratio": "1:1",
        "backgroundMode": "transparent",
        "mattingMode": "通用抠图"
    },
    "callback_url": "https://client.example.com/pod/callback",
    "metadata": {
        "external_order_id": "order-20260601-0001"
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

任务已创建

Bodyapplication/json

示例

{
    "code": "0",
    "message": "ok",
    "data": {
        "task_id": "30df558c-6f94-4c4e-b976-d60569fe595d",
        "status": "CREATED",
        "capability_code": "idetect",
        "request_id": "string"
    }
}

🟠400请求有误

🟠401没有权限

🟠402

🟠403禁止访问

🟠429