提交任务接口

POST/open/face/train

接口能力

上传用户个人照片，训练 AI 模型并生成专属个性化头像

为了达到最好的训练效果，请注意以下内容：

不要上传同样背景或连续拍摄的图片，最好是不同背景，不同场景，但主体一致的照片
图片不要出现多个主体
（人像）可以有不同的表情(效果会更好)，但不要太夸张
画面不要太亮或太暗
主体部分（例如脸）尽量不要被其它东西遮挡
（人像）自拍或特写50%，侧脸30%，半身像20%是最佳的比例
（人像）如果你戴眼镜，在所有照片中都戴上，或者根本不戴

积分扣除规则

按「训练图片张数 * 10 + 生成图片张数 * 2」来扣积分

计算说明
- 训练图片张数：即模型训练用到的图片张数，如果用户上传 10 张图，丢弃了 2 张（过于模糊的图片会被丢弃），只用了 8 张来训练模型，训练图片张数 = 8
- 生成图片张数：即最后生成的图片张数，不包括敏感图检测、失败的推理任务
举例：
- 用户上传 10 张图片进入训练，最后生成 100 张图给用户，扣除「10 * 10 + 100 * 2 = 300」积分
- 用户上传 30 张图进入训练，最后生成 90 张图给用户，扣除「30 * 10 + 90 * 2 = 480」积分

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

Authorization

string

必需

此值可以在开放平台(https://open.creator.nolibox.com) - 应用列表 - 操作中的"TOKEN"中获取。计算方式："Basic " + Base64.encode(App Key:App Secret)

示例值:

Basic xxxxxxxxxx

image_url

array[string]

训练模型所需图片

必需

建议上传 5-20 张照片，图片高和宽必须大于等于 512px，图片大小必须小于等于 3.75MB

sex

enum<string> | enum<null>

性别

可选

会影响生成头像效果；如果为空则会智能识别人物性别

枚举值:

manlady

model_id

enum<string> | enum<null>

模型

可选

默认基于 SD 模型训练

枚举值:

naisd

默认值:

steps

integer | null

迭代步数

可选

如果不传，则使用智能匹配步数

>= 100<= 400

text_encoder_steps

integer | null

迭代步数

可选

如果不传，则使用智能匹配步数。如果传递,推荐的范围在 350-600

prompts

array [object {2}] | null

prompt

可选

如果不传，则使用智能内容推荐，生成 80-100 个头像结果

text

string

prompt

必需

描述词

negative_prompt

string

negative prompt

必需

负面词

width

integer

生成图片宽度

可选

默认值:

512

height

integer

生成图片高度

可选

默认值:

512

{
  "image_url": [
    "http://dummyimage.com/400x400",
    "http://dummyimage.com/400x400",
    "http://dummyimage.com/400x400",
    "http://dummyimage.com/400x400"
  ]
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

data

object

任务唯一ID

必需

task_id

string

必需

{
  "code": 0,
  "data": {
    "task_id": "445113555802726400"
  },
  "msg": "success"
}

最后修改时间： 2 年前