提交模型训练任务

基本说明

此接口用于提交模型训练任务，通过此接口可以提交特定人物用于模型学习，学习完成后可以将模型用于文生图或者图生图处理

此接口为异步处理，任务通过此接口提交后，需通过训练任务详情接口获取训练进度

积分消耗计算

扣除积分量=素材图片数量x100

举例：单次提交训练素材图片为15张素材图，则本次训练扣除积分量为15 * 100 = 1500

素材图片限制与要求

训练素材必须满足以下要求

图片宽度或者高度必须大于512(也就是说最短边不能小于512)

图片宽度或者高度必须小于4000

图片文件大小不能超过20M

图片格式仅支持jpg、png、webp，不支持其他格式

不允许提交重复的素材图

素材图不允许包含违规内容（涉黄、涉政、涉恐等）

训练素材建议满足以下要求以获得更好的效果

系统最终会对图片进行缩放（居中）裁剪以获得512x512大小的图片进行训练，因此:

如果画面是非1:1尺寸图片，请确保人物主体在画面中部

建议素材图片中的训练主体不在画面中部可自行进行处理后再提交任务，以免出现非预期效果

提交的素材宽高比最好原始就是1:1,不会触发系统裁剪处理，画面更可控

图片文件不建议过大，系统会统一缩放成512x512，过大的图片并不会提升训练结果，反而会影响处理速度

请确保画面中不会出现多个人物或者主体

画面中背景不要过于复杂

人物着装表情保持多样化

其他备注说明

，如有更高需求请咨询商务

此接口训练完成的模型会免费获得为期60天的模型托管时间，在模型过期之前会自动进行模型托管续费，无法续费的模型则会自动进行清理，请注意模型有效期，过期清理后模型无法进行使用

更多返回错误代码请看首页的错误代码描述

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json

modelName

string

模型名称

必需

30个字以内，用于标识训练完成后的模型名称

trainConfigId

integer

训练配置ID

必需

用于不同类型风格的模型训练的配置ID，请咨询商务获取

materialImages

array [object {1}]

用于训练素材的图片列表

必需

为保证训练效果，单个模型最少需要提供9个素材图，最多不能超过30个素材图，关于素材图的限制，请参考本页面的训练素材图片部分

url

string

单个图片素材的获取url

必需

请确保此url公网可以访问

callback

string

结果回调地址

可选

支持IP等URL请参考回调使用指南

示例值:

https://exmple.com/callback

nonce

string

自定义请求回调标识

可选

任意长度不超过32的字符串，具体请参考回调使用指南

<= 32 字符

示例

{
  "modelName": "章子怡",
  "trainConfigId": 9,
  "materialImages": [
    {
      "url": "https://plc.jj20.com/up/allimg/mx10/010220233P1/200102233P1-0.jpg"
    },
    {
      "url": "https://plc.jj20.com/up/allimg/mx10/010220233P1/200102233P1-0.jpg"
    },
    {
      "url": "https://plc.jj20.com/up/allimg/mx10/010220233P1/200102233P1-1.jpg"
    },
    {
      "url": "https://plc.jj20.com/up/allimg/mx10/010220233P1/200102233P1-2.jpg"
    },
    {
      "url": "https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fc-ssl.duitang.com%2Fuploads%2Fitem%2F201711%2F06%2F20171106210909_4Zwdh.jpeg&refer=http%3A%2F%2Fc-ssl.duitang.com&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=auto?sec=1702007668&t=1fa3663480fb38beb7739276b94bfa8b"
    },
    {
      "url": "https://att2.citysbs.com/hangzhou/2018/12/10/13/middle_1800x2700-130800_v2_20501544418480679_cd92db59d39e598c000b0e9df78bbba0.jpg"
    },
    {
      "url": "https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fc-ssl.duitang.com%2Fuploads%2Fitem%2F201712%2F24%2F20171224203752_jnBJa.thumb.1000_0.jpeg&refer=http%3A%2F%2Fc-ssl.duitang.com&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=auto?sec=1702007668&t=9ee628a78c363276f10da8c19d38c893"
    },
    {
      "url": "https://wx3.sinaimg.cn/mw690/a16023bcgy1hj52z8i5hhj22m43x7b2a.jpg"
    },
    {
      "url": "https://lmg.jj20.com/up/allimg/1112/041319115I8/1Z413115I8-5-1200.jpg"
    },
    {
      "url": "https://ww4.sinaimg.cn/mw690/c419aaedgy1hj53sptm76j20mm148qc5.jpg"
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

data

object

必需

taskId

string

任务ID

必需

可用于获取获取任务进度或者结果

used

integer

消耗积分

必需

balance

integer

账号剩余积分

必需

code

integer

API统一响应码

必需

错误码请参考此文档

msg

string

错误消息

必需

如果本次接口请求错误，则会返回对应的错误描述

success

boolean

是否处理成功

必需

简易字段用于区分本次请求接口是否处理成功

示例

成功示例异常示例

{
  "data": {
    "taskId": "a8541ca6aed44b7e8e20e521d3696d42",
    "used": 900,
    "balance": 1066195
  },
  "code": 0,
  "success": true
}

基本说明#

积分消耗计算#

素材图片限制与要求#

其他备注说明#

请求参数

示例代码

返回响应

基本说明

积分消耗计算

素材图片限制与要求

其他备注说明