Skip to content

印花提取(Extract Printing) ​

从服装、布料或商品照片中提取印花图案,输出可用于二次设计或套图的独立印花图。默认 2.0:可选宽高比与 1k / 1.5k / 2k,一次 1 张。传 engine=v1 则走 1.0,可一次出 1–4 张。

在编辑器中试用:印花提取。

基本信息 ​

项目值
接口路径POST /image/extract-printing
所需 Scopeextract_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"
}

参数说明 ​

参数类型必填默认值说明
requestIdstring否服务端生成调用方请求 ID,用于幂等去重。省略时由服务端生成并在响应里返回
urlstring是—含印花原图的公开 HTTPS URL
enginestring否v2v2(默认 2.0,可选尺寸,一次 1 张)或 v1(1.0,可一次 1–4 张)
arstring否1:1输出宽高比,如 1:1、16:9、9:16、4:3、3:4、3:2、2:3。auto 不固定成 1:1,按图案实际宽高
outputResolutionstring否1k1k / 1.5k / 2k。仅 2.0 生效。未传时为 1k;transparent=true 且未传时为 2k。engine=v1 时忽略该字段,1.0 固定按 1.5k 档出图
transparentboolean否false仅 2.0。false 为白底,true 为透明底。engine=v1 时忽略
countinteger否12.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 档。

妙图设计 API Beta