触站AI开放平台API

提交模型训练任务

POST/aiapi/v1/training

最后修改时间： 10 个月前

基本说明

此接口用于提交模型训练任务，通过此接口可以提交特定人物用于模型学习，学习完成后可以将模型用于文生图或者图生图处理
此接口为异步处理，任务通过此接口提交后，需通过训练任务详情接口获取训练进度

积分消耗计算

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

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

素材图片限制与要求

训练素材必须满足以下要求
1. 图片宽度或者高度必须大于512(也就是说最短边不能小于512)
2. 图片宽度或者高度必须小于4000
3. 图片文件大小不能超过20M
4. 图片格式仅支持jpg、png、webp，不支持其他格式
5. 不允许提交重复的素材图
6. 素材图不允许包含违规内容（涉黄、涉政、涉恐等）
训练素材建议满足以下要求以获得更好的效果
1. 系统最终会对图片进行缩放（居中）裁剪以获得512x512大小的图片进行训练，因此:
  - 如果画面是非1:1尺寸图片，请确保人物主体在画面中部
  - 建议素材图片中的训练主体不在画面中部可自行进行处理后再提交任务，以免出现非预期效果
  - 提交的素材宽高比最好原始就是1:1,不会触发系统裁剪处理，画面更可控
2. 图片文件不建议过大，系统会统一缩放成512x512，过大的图片并不会提升训练结果，反而会影响处理速度
3. 请确保画面中不会出现多个人物或者主体
4. 画面中背景不要过于复杂
5. 人物着装表情保持多样化

其他备注说明

此接口单个客户限制最高同时训练数量为1，如有更高需求请咨询商务
此接口训练完成的模型会免费获得为期60天的模型托管时间，在模型过期之前会自动进行模型托管续费，无法续费的模型则会自动进行清理，请注意模型有效期，过期清理后模型无法进行使用
更多返回错误代码请看首页的错误代码描述

请求参数

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"
    }
  ]
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

data

object

必需

taskId

string

任务ID

必需

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

used

integer

消耗积分

必需

balance

integer

账号剩余积分

必需

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

最后修改时间： 10 个月前