人物写真生成 — 创建任务

POST

/services/aigc/album/gen_potrait

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/album/gen_potrait' \
--header 'X-DashScope-Async: enable' \
--header 'Authorization: Bearer $DASHSCOPE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "model": "facechain-generation",
  "parameters": {
    "style": "f_idcard_female",
    "size": "768*1024",
    "n": 4
  },
  "resources": [
    {
      "resource_id": "women_model",
      "resource_type": "facelora"
    }
  ]
}'

{
  "request_id": "0b6a411a-56e6-9028-84eb-6852183248d8",
  "output": {
    "task_id": "7eb1032e-09a1-4df5-96ed-14091859ad57",
    "task_status": "PENDING"
  }
}

请先获取 API Key 并设置为环境变量。

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

Header 参数

enum<string>

必填

固定设置为 enable，表示使用异步方式提交任务。

可选值：enable

请求体

application/json

enum<string>

必填

模型名称。此处固定为 facechain-generation。

可选值：facechain-generation

示例:facechain-generation

object[]

人物形象 LoRA 资源列表。使用预设风格或自定义模板模式（非免训练模式）时为必填，从人物形象训练 API 获取。使用免训练模式（TrainFree）时无需填写，填写也会被忽略。

显示子属性

string

模型定制得到的 LoRA 数据 ID，从人物形象训练任务的成功结果中获取。

示例:women_model

enum<string>

资源类型。固定为 facelora。

可选值：facelora

示例:facelora

object

生成参数。

显示子属性

string

输出图像的预设风格或自定义模板模式。

预设风格（需要 LoRA 资源）：

f_idcard_male — 证件照男
f_business_male — 商务写真男
f_idcard_female — 证件照女
f_business_female — 商务写真女
m_springflower_female — 春日花园
f_summersport_female — 夏日运动
f_autumnleaf_female — 秋日印象
m_winterchinese_female — 冬日国风
f_hongkongvintage_female — 港风复古
f_lightportray_female — 轻写真

自定义模板模式：

portrait_url_template — 自定义模板 + LoRA（需传入 input.template_url 和 LoRA 资源）
train_free_portrait_url_template — 自定义模板免训练（需传入 input.template_url 和 input.user_urls，无需 LoRA 资源）

示例:f_idcard_female

string

生成图像的分辨率。目前支持 768*1024。使用自定义模板模式或免训练模式时不需要该参数。

示例:768*1024

integer

默认值4

生成图片数量。取值范围 1~4，默认值为 4。

示例:4

取值范围：1 <= x <= 4

boolean

默认值true

免训练写真生成时是否对输入用户图进行自动美颜处理。默认为 true（自动美颜），可设置为 false（不美颜，用户可自行前后处理）。

object

自定义模板模式下的输入数据。

显示子属性

string

用户自定义模板的 URL 链接。当 parameters.style 为 portrait_url_template 或 train_free_portrait_url_template 时为必填。

格式：JPEG、JPG、PNG
大小：不超过 5MB
分辨率：512×512 ~ 1680×1260 像素
要求：单人、清晰且高质量的风格模板图，人脸无遮挡和模糊。URL 中不能包含中文字符。

示例:https://example.com/template.jpg

string[]

一组包含用户正脸单人照的 URL 链接。当 parameters.style 为 train_free_portrait_url_template 时为必填。至少 1 张，最多 5 张，需通过人物图像检测 API（facechain-facedetect）验证通过。

格式：JPEG、JPG、PNG
大小：每张不超过 3MB
分辨率：256×256 ~ 2048×2048 像素
人脸：占比不低于 128×128 像素
要求：清晰正脸单人照，人脸角度不超过 15 度。URL 中不能包含中文字符。

示例:

[
  "https://example.com/face.jpg"
]

取值范围：items: 1–5

响应

200-application/json

string

本次请求的系统唯一码。

示例:0b6a411a-56e6-9028-84eb-6852183248d8

object

显示子属性

string

提交异步任务的作业 ID。实际作业结果需要通过异步任务查询接口获取。

示例:7eb1032e-09a1-4df5-96ed-14091859ad57

enum<string>

提交异步任务后的作业状态，初始状态通常为 PENDING。

可选值：PENDING,RUNNING,SUCCEEDED,FAILED,UNKNOWN