AI换模特 API 接口文档

POST/image/v2/make/changeModelapplication/json

请求体

素材的格式、大小、尺寸和比例为业务使用要求，部分在任务执行或上游调用阶段检查；创建成功不代表已通过全部素材校验。上传限制与具体业务素材要求分别适用。

imageUrlstring必填

模特原图

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

imageSegUrlstring可选

模特原图保留区抠图结果

modelHeadImageUrlstring必填

模特头部图

方式一 · 图片地址

格式：jpg、jpeg、png、webp大小：5M以内尺寸：512×512～2048×2048

方式二 · 作图素材调用作图素材取地址(type=1)

sceneImgUrlstring可选

场景参考图

方式一 · 图片地址

格式：jpg、jpeg、png、webp大小：10M以内尺寸：768×768～4096×4096

方式二 · 作图素材调用作图素材取地址(type=2预设场景或 type=4场景素材)

建议使用场景素材，效果稳定

sceneStrengthstring可选默认0.7

场景相似度，值越大越相似取值范围 [0,1]

modelPromptstring可选

模特特征参数
多选用','号拼接

customPromptstring可选

高级自定义描述，建议控制在 600 字符以内；当前接口未在提交时按 600 字符拒绝，提交成功不代表上游支持任意长度。

customNegPromptstring可选

画面中不需要的元素

genOriResboolean可选默认false

是否生成原分辨率图
false为默认尺寸

realModelboolean可选默认true

模特原图是否真人模特false为人台

outputNumnumber可选默认1

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

请求示例

JSON

{
  "imageUrl": "https://cdn.linkfox.com/ai-site/test/workbench/modelExample2.jpg",
  "modelHeadImageUrl": "https://cdn.linkfox.com/ai-site/test/workbench/model_women_demo.jpeg",
  "sceneImgUrl": "https://linkfoxai-ailab.oss-cn-shenzhen.aliyuncs.com/UPLOAD/1840234601622503424/2024/11/26/50ef69c7750640d7a25637ee86a4ba79.jpg",
  "outputNum": 4
}

模特特征参数字典表

类型	关键字
表情
-	微笑
-	大笑
姿势
-	坐着
-	躺着
体型
-	肥胖
-	微胖
-	苗条
角度
-	侧身
-	侧脸
其他
-	背面
-	光头

提交后返回什么

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

查询生成结果

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

扣费标准

每张 20 点；选择原分辨率输出时每张 25 点。

创建上限

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