文档中心

Appearance

生成数字人视频 ​

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

创建图生视频任务 ​

说明 ​

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

RPM 10/min
任务并发 1

请求地址 ​

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

请求参数 Body ​

字段类型是否必传示例说明
photo_unique_idstring是2d681fd7-d9ad-4645-86b4-3b5e30430705来源文生图任务 ID
photo_pathstring是https://.../demo.png图片地址
emotionstring否热情地说话，带着严肃的表情情感提示词，长度上限 800
gesturebool否true是否启用动作
modelstring否1.0(默认)1.0(Kling 1.6)
2.0-plus(Kling 2.5标准版)
2.0-ultra(高质版)
3.0(Seedance 1.0 Lite)

请求示例 ​

json
{
  "emotion": "热情地说话，带着严肃的表情，眉头略微皱起，手势强调重点",
  "gesture": true,
  "photo_path": "https://algorithm-test-modeldata.oss-cn-shanghai.aliyuncs.com/demo.png",
  "photo_unique_id": "2d681fd7-d9ad-4645-86b4-3b5e30430705"
}

响应示例 ​

json
{
  "trace_id": "7ef9c35e9b4bdabbee644b730e31873e",
  "code": 0,
  "msg": "success",
  "data": "783197c0-13da-4463-ae80-8cee37c7d8f5"
}

响应字段说明 ​

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

响应状态码说明 ​

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

获取图生视频任务列表 ​

说明 ​

分页查询图生视频任务列表。

RPM 10/min

请求地址 ​

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

Header ​

http
access_token: {{access_token}}

请求参数 Query ​

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

响应示例 ​

json
{
  "trace_id": "269bde633428bae6e18873599f49311e",
  "code": 0,
  "msg": "success",
  "data": [
    {
      "id": 1017,
      "unique_id": "783197c0-13da-4463-ae80-8cee37c7d8f5",
      "create_time": 1750066711,
      "type": 2,
      "progress_desc": "Success",
      "err_msg": "",
      "aspect_ratio": 0,
      "output_url": ["https://example.com/xxx.mp4"],
      "photo_info": {},
      "motion_info": {}
    }
  ]
}

响应字段说明 ​

一级字段二级字段说明
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 为单视频）
photo_info文生图任务详细信息
motion_info图生视频任务详细信息

响应状态码说明 ​

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

获取图生视频任务详情 ​

说明 ​

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

RPM 10/min

请求地址 ​

http
GET /open/v1/aigc/motion/task

Header ​

http
access_token: {{access_token}}

请求参数 Query ​

字段类型是否必传示例说明
unique_idstring是783197c0-13da-4463-ae80-8cee37c7d8f5创建任务时返回的任务 ID

响应示例 ​

json
{
  "trace_id": "b9064c0bbe681d10cf3eab05845c71ae",
  "code": 0,
  "msg": "success",
  "data": {
    "id": 1017,
    "unique_id": "783197c0-13da-4463-ae80-8cee37c7d8f5",
    "create_time": 1750066711,
    "type": 2,
    "progress_desc": "Success",
    "err_msg": "",
    "aspect_ratio": 0,
    "output_url": ["https://example.com/xxx.mp4"],
    "photo_info": {},
    "motion_info": {}
  }
}

响应字段说明 ​

一级字段二级字段说明
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 为单视频）
photo_info文生图任务详细信息
motion_info图生视频任务详细信息

响应状态码说明 ​

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