主题
印花提取(Extract Printing)
从服装、布料或商品照片中提取印花图案,输出可用于二次设计或套图的独立印花图。默认 2.0:可选宽高比与 1k / 1.5k / 2k,一次 1 张。传 engine=v1 则走 1.0,可一次出 1–4 张。
在编辑器中试用:印花提取。
基本信息
| 项目 | 值 |
|---|---|
| 接口路径 | POST /image/extract-printing |
| 所需 Scope | extract_printing(规范名)或别名 extract-printing,或 * |
| 任务类型 | 异步,返回 taskId;成功时 taskType 为 extract-printing |
| 算法 | 默认 2.0(engine=v2,miaotu)。传 engine=v1 切回 1.0 |
请求参数
json
{
"requestId": "可选,调用方自定义唯一 ID",
"url": "含印花原图的公开 HTTPS URL(必填)",
"engine": "可选,v2(默认)或 v1",
"ar": "可选,默认 1:1。也可传 auto,或 16:9 这类宽:高",
"outputResolution": "可选,1k / 1.5k / 2k。省略时 1k;transparent=true 且省略时为 2k。engine=v1 时忽略,1.0 按 1.5k 档",
"transparent": "可选,仅 2.0。默认 false(白底)。true 为透明底",
"count": "可选。engine=v2 时服务端锁 1;engine=v1 时 1–4,默认 1"
}参数说明
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
requestId | string | 否 | 服务端生成 | 调用方请求 ID,用于幂等去重。省略时由服务端生成并在响应里返回 |
url | string | 是 | — | 含印花原图的公开 HTTPS URL |
engine | string | 否 | v2 | v2(默认 2.0,可选尺寸,一次 1 张)或 v1(1.0,可一次 1–4 张) |
ar | string | 否 | 1:1 | 输出宽高比,如 1:1、16:9、9:16、4:3、3:4、3:2、2:3。auto 不固定成 1:1,按图案实际宽高 |
outputResolution | string | 否 | 1k | 1k / 1.5k / 2k。仅 2.0 生效。未传时为 1k;transparent=true 且未传时为 2k。engine=v1 时忽略该字段,1.0 固定按 1.5k 档出图 |
transparent | boolean | 否 | false | 仅 2.0。false 为白底,true 为透明底。engine=v1 时忽略 |
count | integer | 否 | 1 | 2.0 服务端锁 1 张。1.0 为 1–4 |
url 须为服务能访问的 HTTPS 地址。本地文件先调用 POST /images/upload,把返回的 data.url 作为 url。
请求示例
默认 2.0:
bash
curl -s -X POST \
-H "Authorization: Bearer $TUSEN_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/tshirt.jpg",
"ar": "1:1"
}' \
"https://magiqsight.com/openapi/v1/image/extract-printing"切回 1.0、一次 2 张:
bash
curl -s -X POST \
-H "Authorization: Bearer $TUSEN_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/tshirt.jpg",
"engine": "v1",
"ar": "1:1",
"count": 2
}' \
"https://magiqsight.com/openapi/v1/image/extract-printing"响应示例
json
{
"code": 0,
"data": {
"requestId": "req_abc123",
"taskId": "task_xyz"
},
"msg": ""
}获得 taskId 后,通过 GET /tasks/{taskId} 轮询结果。
任务成功(status: 1)后,resultType 为 image,结果在 imageUrls。任务失败(status: 2)时查看 resultMetadata。
默认 2.0,省略分辨率时为
1k,一次一张。要1.5k或2k时再传outputResolution。要透明底时传"transparent": true(此时省略分辨率则为2k)。要 1.0 多张时传"engine": "v1"和count;1.0 不看outputResolution,画布按1.5k档。
