Skip to main content
POST
cURL
使用此端点可将参考片段中的表演迁移到角色图片或角色视频上。

调用前准备

  • 发送必需的 X-Runway-Version 请求头,例如 2024-11-06
  • 使用 model: act_two
  • 提供一个 character 资源和一个 reference 资源,且它们都必须是可访问的 HTTPS URL
  • 在调整风格前,先以 bodyControl: true 和适中的 expressionIntensity 开始

输出比例

任务流程

1

提交角色表演请求

使用你的角色资源、参考资源和动作设置创建任务。
2

保存返回的任务 id

保留返回的 id,因为后续轮询时需要用到它。
3

轮询任务状态

继续使用 获取 Runway 任务,直到任务进入终态,且 provider 元数据包含已完成的输出。

输入角色

  • character 是你想要添加动画效果的主体
  • reference 是提供面部表演或身体动作的源片段
  • bodyControl 决定动作迁移是否除表情迁移外还包含身体运动
  • contentModeration 将 provider 的内容审核阈值应用到该请求

授权

Authorization
string
header
必填

Bearer token authentication. Use your CometAPI key.

请求头

X-Runway-Version
string
必填

Runway version header, for example 2024-11-06.

请求体

application/json
character
object
必填

The character to control. You can either provide a video or an image.

reference
object
必填

Reference performance clip. Provide type (video) and uri (HTTPS URL).

bodyControl
boolean
默认值:true
必填

Enable body control.

expressionIntensity
integer
默认值:1
必填

Intensity of the expression transfer. Higher values produce more exaggerated expressions.

seed
integer
默认值:1
必填

Random seed for reproducible results.

model
string
默认值:act_two
必填

The model variant to use. Must be act_two.

ratio
string
默认值:1280:720
必填

Requested output frame shape, for example 1280:720 or 720:1280. Keep the character and reference assets close to the requested frame shape.

contentModeration
object
必填

响应

200 - application/json

Task accepted.

id
string
必填