触站AI开放平台API
  1. 模型训练
触站AI开放平台API
  • 触站AI API接口使用说明
  • 返回结构
  • 更新历史
  • 基础
    • 获取当前客户详情以及积分情况
  • 工作流(AI小工具)
    • 1.获取工作流(小工具)字段详情
      POST
    • 2.提交工作流(小工具)任务执行
      POST
    • 3.获取工作流(小工具)任务进度或结果
      POST
  • 应用工具(电商工具)
    • 获取应用工具选项详情
    • 提交应用工具任务
  • 通用AI绘画(触站AI绘画)
    • 提交绘画任务积分计算说明
    • controlnet使用指南
    • 提交绘画任务
    • 获取绘画任务详情
    • 提交局部重绘绘画任务
  • 模型训练
    • 提交模型训练任务
      POST
    • 获取模型训练进度或者结果
      POST
  • MJ绘画
    • 提交Midjourney绘画任务
    • 使用Midjourney获取特定图片的画面描述
    • 提交Midjourney单图放大任务
    • 提交Midjourney单图扩写绘画任务
    • 提交Midjourney单图variation(变种)任务
    • 获取Midjourney任务详情(含进度)
  • 示例&DEMO
    • DEMO | 1分钟快速实现一个AI绘画页面
    • 高级模型 | 最能听懂人话的AI绘画模型-效果展示
    • 风格ID | 不同风格效果参考(内含ModelStyleID)
    • 示例 | 通过API实现图片中隐藏文字或者图案的效果
    • 示例 | 关于大尺寸图片参数的最佳实践(惊悚慎入)
    • 示例 | 使用回调获取任务结果的最佳实践
    • 示例 | 局部重绘处理
    • 示例 | 如何使用工作流接口进行绘图
    • 概念解析 | 工作流使用独立算力卡运行【独占模式】
    • 风格上新
      • 黏土风格
  1. 模型训练

提交模型训练任务

POST
https://ai.huashi6.com/aiapi/v1/training
最后修改时间:2024-01-17 03:58:35
基本说明#
此接口用于提交模型训练任务,通过此接口可以提交特定人物用于模型学习,学习完成后可以将模型用于文生图或者图生图处理
此接口为异步处理,任务通过此接口提交后,需通过训练任务详情接口获取训练进度
积分消耗计算#
扣除积分量=素材图片数量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.
人物着装表情保持多样化
其他备注说明#
,如有更高需求请咨询商务
此接口训练完成的模型会免费获得为期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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://ai.huashi6.com/aiapi/v1/training' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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成功
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
}
上一页
提交局部重绘绘画任务
下一页
获取模型训练进度或者结果
Built with