文档中心

Appearance

生成数字人图片 ​

本能力曾用名：文生图（生成式数字人流程中的图片生成环节）。

创建文生图任务 ​

说明 ​

异步任务接口，用于创建文生图任务，具体进度请通过任务查询接口获取。

RPM 10/min
任务并发 1

请求地址 ​

http
POST /open/v1/aigc/photo
http
access_token: {{access_token}}
Content-Type: application/json

请求参数 Body ​

字段类型是否必传示例说明
agestring是Young adult年龄提示词（Young adult、Adult、Teenager、Elderly）
backgroundstring否夜晚热闹市井背景背景提示词，长度上限 1500
detailstring否温柔的中长发，搭配烘焙头巾细节提示词，长度上限 1500
genderstring是Female性别（Male/Female）
talking_posestring否上半身特写，站着讲话姿势提示词，长度上限 1500
industrystring否餐饮美食行业提示词
originstring否Chinese人种提示词（European、African、South Asian、Japanese...）
aspect_ratioint否0宽高比，0=9:16，1=16:9，默认 0
number_of_imagesint是1生成图片张数，1-4
ref_img_urlstring否https://.../demo.png参考图链接
ref_contentstring否style参考内容（style 风格 / appearance 长相）
modelstring否默认1.01.0(知了模型)
2.0(Seedream3.0)
2.1(知了模型2.0)
3.0(Seedream 4.0)
4.0(Seedream 4.5)

请求示例 ​

json
{
  "age": "Young adult",
  "background": "夜晚热闹市井背景，烟火气十足，坐在街边小摊",
  "detail": "温柔的中长发，搭配烘焙头巾或发带，显得专业又亲切",
  "gender": "Female",
  "industry": "餐饮美食",
  "talking_pose": "上半身特写，站着，双手自然交叠或垂放在身侧",
  "number_of_images": 1,
  "aspect_ratio": 0,
  "origin": "Chinese",
  "ref_img_url": "https://algorithm-test-modeldata.oss-cn-shanghai.aliyuncs.com/demo.png",
  "ref_content": "style"
}

响应示例 ​

json
{
  "trace_id": "78d43f898d3c325530b5f1a5a0450414",
  "code": 0,
  "msg": "success",
  "data": "2d681fd7-d9ad-4645-86b4-3b5e30430705"
}

响应字段说明 ​

字段说明
code响应状态码
msg响应消息
trace_id请求链路追踪 ID
data文生图任务 ID

响应状态码说明 ​

code说明
0响应成功
400传入参数格式错误
10400AccessToken 验证失败
40000参数错误
40001超出 RPM 限制
50000系统内部错误

获取文生图任务列表 ​

说明 ​

分页查询文生图任务列表。

RPM 10/min

请求地址 ​

http
GET /open/v1/aigc/photo/task/page

Header ​

http
access_token: {{access_token}}

请求参数 Query ​

字段类型是否必传示例说明
pageint否1页码，默认 1
page_sizeint否10每页数量，默认 10

响应示例 ​

json
{
  "trace_id": "a226f8335e2610de1a89c98416137009",
  "code": 0,
  "msg": "success",
  "data": [
    {
      "id": 3945,
      "unique_id": "2d681fd7-d9ad-4645-86b4-3b5e30430705",
      "create_time": 1750061854,
      "type": 1,
      "progress_desc": "Success",
      "err_msg": "",
      "aspect_ratio": 0,
      "output_url": ["https://example.com/xxx.png"],
      "photo_info": {},
      "motion_info": {},
      "waiting_num": 0
    }
  ]
}

响应字段说明 ​

一级字段二级字段说明
code响应状态码
msg响应消息
data响应数据列表
id任务 ID
unique_id任务唯一 ID
create_time创建时间（时间戳）
type任务类型，1=photo，2=motion
progress_desc任务状态：Ready / Generating / Queued / Error / Success
err_msg错误信息
aspect_ratio宽高比，0=9:16，1=16:9
output_url输出地址（photo 可能为多图，motion 为单视频）
waiting_num等待调度排队数
photo_info文生图任务详细信息
motion_info图生视频任务详细信息

响应状态码说明 ​

code说明
0响应成功
400传入参数格式错误
10400AccessToken 验证失败
40000参数错误
40001超出 RPM 限制
50000系统内部错误

获取文生图任务详情 ​

说明 ​

根据任务唯一 ID 查询单个文生图任务详情。

RPM 10/min

请求地址 ​

http
GET /open/v1/aigc/photo/task

Header ​

http
access_token: {{access_token}}

请求参数 Query ​

字段类型是否必传示例说明
unique_idstring是2d681fd7-d9ad-4645-86b4-3b5e30430705创建任务时返回的任务 ID

响应示例 ​

json
{
  "trace_id": "e74f8d4dfd2bb4cc1d81f748fd74882a",
  "code": 0,
  "msg": "success",
  "data": {
    "id": 3945,
    "unique_id": "2d681fd7-d9ad-4645-86b4-3b5e30430705",
    "create_time": 1750061854,
    "type": 1,
    "progress_desc": "Success",
    "err_msg": "",
    "aspect_ratio": 0,
    "output_url": ["https://example.com/xxx.png"],
    "photo_info": {},
    "motion_info": {},
    "waiting_num": 0
  }
}

响应字段说明 ​

一级字段二级字段说明
code响应状态码
msg响应消息
data响应数据
id任务 ID
unique_id任务唯一 ID
create_time创建时间（时间戳）
type任务类型，1=photo，2=motion
progress_desc任务状态：Ready / Generating / Queued / Error / Success / Fail
err_msg错误信息
aspect_ratio宽高比，0=9:16，1=16:9
output_url输出地址（photo 可能为多图，motion 为单视频）
waiting_num等待调度排队数
photo_info文生图任务详细信息
motion_info图生视频任务详细信息

响应状态码说明 ​

code说明
0响应成功
400传入参数格式错误
10400AccessToken 验证失败
40000参数错误
40001超出 RPM 限制
50000系统内部错误