视频换人 API 接口文档

重要提示：必须新建分组为 transparent（透传）的 API Key 才可以调用本接口！

概述

视频换人接口支持将视频中的人物替换为其他人物形象，采用异步任务模式，需要轮询任务状态获取结果。

接口信息

项目	说明
请求方式	POST
Content-Type	application/json
Base URL	`https://api.silra.cn/transparent`
请求路径	`/api/v1/services/aigc/video-generation/video-synthesis`
完整URL	`https://api.silra.cn/transparent/api/v1/services/aigc/video-generation/video-synthesis`

认证方式

在请求头中添加 Authorization 字段：

Authorization: Bearer YOUR_API_KEY

使用分组为 transparent（透传）的令牌

请求参数

注意：以下参数说明仅供参考，无法实时同步阿里百炼官方文档。请求参数请优先以阿里百炼官网文档为准。
详细参数请参考阿里百炼官方文档：视频换人 API

请求体示例

{
  "model": "wan2.2-facechain",
  "input": {
    "video_url": "https://example.com/video.mp4",
    "face_image_url": "https://example.com/face.jpg"
  },
  "parameters": {
    "quality": "high"
  }
}

参数说明

参数名	类型	必填	说明
model	string	是	模型名称
input.video_url	string	是	输入视频URL
input.face_image_url	string	是	目标人脸图片URL
parameters.quality	string	否	输出质量：`low`、`medium`、`high`

响应示例

提交任务响应

{
  "request_id": "xxxxx-xxxxx-xxxxx",
  "task_id": "task-xxxxx",
  "task_status": "PENDING"
}

任务状态说明

状态	说明
PENDING	任务等待中
RUNNING	任务执行中
SUCCEEDED	任务成功
FAILED	任务失败

查询任务结果

请求信息

项目	说明
请求方式	GET
请求路径	`/transparent/api/v1/tasks/{taskId}`
完整URL	`https://api.silra.cn/transparent/api/v1/tasks/{taskId}`

查询响应示例

{
  "request_id": "xxxxx-xxxxx-xxxxx",
  "task_id": "task-xxxxx",
  "task_status": "SUCCEEDED",
  "output": {
    "video_url": "https://xxx.oss-cn-beijing.aliyuncs.com/xxx.mp4"
  }
}

计费说明

计费方式：按视频时长（秒）计费

价格优惠：统一按阿里云官网价格 5折扣费

扣费明细：可在「使用记录」中查看

代码示例

cURL

Python

官方文档参考

阿里百炼视频换人 API 文档

视频换人

视频换人 API 接口文档#

概述#

接口信息#

认证方式#

请求参数#

请求体示例#

参数说明#

响应示例#

提交任务响应#

任务状态说明#

查询任务结果#

请求信息#

查询响应示例#

计费说明#

代码示例#

cURL#

Python#

官方文档参考#

视频换人 API 接口文档

概述

接口信息

认证方式

请求参数

请求体示例

参数说明

响应示例

提交任务响应

任务状态说明

查询任务结果

请求信息

查询响应示例

计费说明

代码示例

cURL

Python

官方文档参考