图案裁剪

POST

/openapi/v1/tasks/icrop

一次请求只创建一个图案裁剪任务，返回 task_id 后轮询查询。图片输入可传 imageUrl 或 assetId；产品类型固定按通用模式处理。

本接口无业务枚举参数。

请求参数

Header 参数

Body 参数application/json

示例

{
    "input": {
        "imageUrl": "https://example.com/input.png"
    },
    "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

curl --location '/openapi/v1/tasks/icrop' \
--header 'X-Idempotency-Key;' \
--header 'x-api-key: {{api_key}}' \
--header 'Content-Type: application/json' \
--data '{
    "input": {
        "imageUrl": "https://example.com/input.png"
    },
    "callback_url": "https://client.example.com/pod/callback",
    "metadata": {
        "external_order_id": "order-20260601-0001"
    }
}'

返回响应

🟢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

修改于 2026-06-08 09:06:35

图案提取 V2

图生图