模型名称

segment_hd_common_image

说明
对单张图片进行通用高清分割，并返回透明底 PNG 结果地址。

请求

Method：POST
Content-Type：application/json
路径：/v1/app/tools/segment_hd_common_image

请求头

Header	必填	说明
Authorization	是	平台 Token，支持 `Bearer <token>` 或直接 token。

请求参数

参数	类型	必填	说明
model	string	是	固定传 `segment_hd_common_image`。
image_url	string	是	图片 URL，需公网可访问，且不能包含中文字符。

图片限制（服务端校验）

图片格式：PNG、JPEG、JPG、BMP

图片大小：不超过 40MB

图像分辨率：大于 32×32，小于 10000×10000

image_url 不能包含中文字符

提交响应（示例）

{
  "trace_id": "c7d4eab2b8d62c131775969885",
  "task_id": "F5B89268-EBE8-5699-A0D9-3B09F1A37EAC",
  "status": "in_progress",
  "message": "该调用为异步调用，任务已提交成功，请以requestId的值作为jobId参数调用同类目下GetAsyncJobResult接口查询任务执行状态和结果。"
}

响应字段

字段	类型	说明
trace_id	string	平台任务追踪 ID
task_id	string	异步任务 ID，请用于后续查询
status	string	提交后固定为 `in_progress`
message	string	返回的提交说明

查询任务

Method：GET
路径：/v1/app/tools/segment_hd_common_image/{task_id}

查询成功（示例）

{
  "trace_id": "c7d4eab2b8d62c131775969885",
  "task_id": "F5B89268-EBE8-5699-A0D9-3B09F1A37EAC",
  "status": "completed",
  "image_url": "http://xxx.aliyuncs.com/.../image.png?...",
  "message": "处理成功"
}

查询处理中（示例）

{
  "trace_id": "c7d4eab2b8d62c131775969885",
  "task_id": "F5B89268-EBE8-5699-A0D9-3B09F1A37EAC",
  "status": "in_progress",
  "message": "任务处理中",
  "upstream_status": "PROCESSING"
}

查询失败（示例）

{
  "trace_id": "c7d4eab2b8d62c131775969885",
  "task_id": "F5B89268-EBE8-5699-A0D9-3B09F1A37EAC",
  "status": "failed",
  "message": "抠图任务失败"
}

错误响应（示例）

{
  "error": {
    "message": "缺少 image_url 参数",
    "type": "invalid_request_error",
    "param": null,
    "code": null
  }
}

常见错误：

model 不能为空

模型不存在或未启用

缺少 image_url 参数

image_url 格式不正确

image_url 不能包含中文字符

图片校验失败（大小 / 分辨率 / 访问失败 / 格式不支持）

说明

该工具为异步接口，必须先 POST 提交，再 GET 查询。

返回的 image_url 为临时地址，平台不做持久化转存。

图片高清分割

模型名称#

请求#

请求头#

请求参数#

图片限制（服务端校验）#

提交响应（示例）#

响应字段#

查询任务#

查询成功（示例）#

查询处理中（示例）#

查询失败（示例）#

错误响应（示例）#

说明#