创建分析任务

创建一个异步分析任务。本接口仅返回 task_id；请通过 GET /skin_api/analyze/result?task_id=... 查询任务状态和分析结果。一次任务只能选择一组 api_code + algorithm_variant。

请求字段

字段	必填	说明
`api_code`	是	能力编码，支持的取值见下方能力列表
`algorithm_variant`	是	算法变体，必须与 `api_code` 组成下方列出的有效组合
`resources`	条件必填	标准图片资源对象；每个值必须是可直接下载的 HTTP/HTTPS URL，图片数量和字段名由能力组合决定
`dimension_codes`	否	仅 `eve_v` 支持；省略或传 `[]` 表示使用当前订单可用的全部维度
`output_options`	否	当前仅 `online_skin + all_race_v2` 使用；省略或传 `{}` 时默认 `mask_format=annotation_image`
`metadata`	否	调用方备注信息，不参与分析，也不会出现在查询结果中；请勿放入密码、Token 或个人敏感信息

支持的能力组合

api_code	algorithm_variant	图片要求	dimension_codes	额度规则
`eve_v`	`standard`	白光正面、左侧、右侧三张必填；其他光源按完整三张提交	支持	成功后扣除一次额度；失败不产生净扣次
`eve_v`	`partition`	与 standard 相同	支持	成功后扣除一次额度；失败不产生净扣次
`online_skin`	`standard`	仅 `front_image`	不支持	成功后扣除一次额度；失败不产生净扣次
`online_skin`	`all_race`	仅 `front_image`	不支持	成功后扣除一次额度；失败不产生净扣次
`online_skin`	`all_race_v2`	仅 `front_image`，或完整的正面、左侧、右侧三张	不支持	成功后扣除一次额度；失败不产生净扣次
`face_pose_correction`	`standard`	仅 `front_image`	不支持	需要有效的 Skin API 订单，不扣除次数
`face_pose_correction`	`all_race`	仅 `front_image`	不支持	需要有效的 Skin API 订单，不扣除次数
`face_pose_correction`	`all_race_v2`	仅 `front_image`，或完整的正面、左侧、右侧三张	不支持	需要有效的 Skin API 订单，不扣除次数
`facial_analysis`	`standard`	仅 `front_image`	不支持	需要有效的 Skin API 订单，不扣除次数
`facial_analysis`	`all_race`	仅 `front_image`	不支持	需要有效的 Skin API 订单，不扣除次数

图片资源规则

Eve V 的 white_front_image、white_left_image、white_right_image 必须同时提供。

Eve V 的 white_glow、cross_polar、parallel_polar、uv 均为可选光源；任一光源一旦提供，就必须提供该光源的正面、左侧、右侧完整三张。

Eve V 提供 parallel_polar 或 uv 时，还必须提供完整的 cross_polar 三张。

单图能力只接受 front_image。支持三张图片的能力只能提供一张正面图片，或同时提供正面、左侧、右侧三张，不能只提供两张。

output_options

当前支持 mask_format：

annotation_image：返回按检测维度分组的标注图片 URL；这是 online_skin + all_race_v2 的默认值。

annotation_json：返回标注 JSON 文件 URL。

其他能力当前不使用 output_options，建议省略或传 {}。

兼容字段

新接入建议使用上方的标准字段。以下字段用于兼容已有调用方式：

pic_url 对应 resources.front_image

json 对应 resources，可传资源对象或 JSON 对象字符串

custom 对应 metadata

detect_mask_type=1 对应 output_options.mask_format=annotation_image

detect_mask_type=2 对应 output_options.mask_format=annotation_json

detect_face_type=1|2 仅校验图片数量是否一致，不用于决定图片数量

图片字段 paralle_polar_* 会按 parallel_polar_* 处理；sensitiveness 会按 sensitivity 处理

标准字段与兼容字段同时出现时，值相同可以接受；值不同时会返回参数冲突。

响应判断

HTTP 200 仅表示请求已被接收，调用方仍需检查 meta.code。meta.code=0 表示任务创建成功，此时 response 只包含 task_id；失败时 response 为 {}。排查调用问题时请提供 meta.req_id。

application/json

HTTP 请求成功。请检查 meta.code；0 表示业务成功。

Bodyapplication/json

示例

创建成功缺少算法变体

任务已创建；请使用 task_id 查询状态和结果。

{
  "meta": {
    "code": 0,
    "msg": "",
    "error": "",
    "req_id": "4826bbfa2ab1db905e6ac2909682746a",
    "request_uri": "/skin_api/analyze/task"
  },
  "response": {
    "task_id": "1776411212089374452"
  }
}

请求字段

支持的能力组合

图片资源规则

output_options

兼容字段

响应判断

请求参数

请求示例代码

返回响应

创建分析任务

请求字段#

支持的能力组合#

图片资源规则#

output_options#

兼容字段#

响应判断#

请求参数

请求示例代码

返回响应

请求字段

支持的能力组合

图片资源规则

output_options

兼容字段

响应判断