手持商品 API 接口文档

手持商品

POST/image/v2/make/handHeldapplication/json

请求体

imageUrlstring必填

手持商品图

格式：jpg、jpeg、png、webp大小：20M以内尺寸：385×385～8192×8192

targetOriginUrlstring必填

手持姿势图
1. 自定义图片地址
2. 调用作图素材取地址(type=8)

targetMaskUrlstring条件必填

手持姿势手持区域图片（黑白图尺寸与原图一致）
手持姿势图为自定义图片地址时必填

outputNumnumber可选默认1

输出张数取值范围：[1,4]

请求示例

JSON

{
  "imageUrl": "https://linkfoxai-ailab.oss-cn-shenzhen.aliyuncs.com/UPLOAD/1795336734728318976/2024/12/06/f8703b6b802c4c6c83fad152e2a7c07d.webp",
  "targetOriginUrl": "https://linkfoxai-ailab.oss-cn-shenzhen.aliyuncs.com/UPLOAD/1795336734728318976/2024/12/06/10dbbb7649a5445c87184ab287ed3b4b.png",
  "targetMaskUrl": "https://linkfoxai-ailab.oss-cn-shenzhen.aliyuncs.com/UPLOAD/1795336734728318976/2024/12/16/3ce9190e4ce64f2f88406d36409ffc55.png",
  "outputNum": 1
}

提交后返回什么

提交成功后返回任务编号 data.id，表示任务已创建，结果还需等待生成。请保存编号。查看返回示例。

查询生成结果

用任务编号 data.id 调用获取作图结果，每次查询至少间隔 10 秒。data.status=3 表示成功；若生成了图片或视频，从 data.resultList[].url 获取地址。data.status=4 表示失败。查看统一示例。

扣费标准

每张 20 点。

创建上限

配置项	上限
创建中 / 生成中任务上限	100 个