跳转到主要内容
POST
/
runwayml
/
v1
/
character_performance
Create a Runway character-performance task
curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/character_performance \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "character": {
    "type": "video",
    "uri": "https://filesystem.site/cdn/20250818/wAKbHUoj5EHyqZvEdJbFXn10wXBMUn.mp4"
  },
  "reference": {
    "type": "video",
    "uri": "https://filesystem.site/cdn/20250818/wAKbHUoj5EHyqZvEdJbFXn10wXBMUn.mp4"
  },
  "bodyControl": true,
  "expressionIntensity": 3,
  "seed": 4294967295,
  "model": "act_two",
  "ratio": "1280:720",
  "contentModeration": {
    "publicFigureThreshold": "auto"
  }
}
'
{
  "id": "5b91e444-c232-deaf-a4d7-8aef3e57336b"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
调用前准备

  • 发送必需的 X-Runway-Version 请求头，例如 2024-11-06
  • 使用 model: act_two
  • 提供一个 character 资源和一个 reference 资源，且二者都必须是可访问的 HTTPS URL
  • 在调整风格之前，先使用 bodyControl: true 和适中的 expressionIntensity 作为起点

​
任务流程

1

提交角色表演请求

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

保存返回的任务 id

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

轮询任务状态

继续使用 获取任务详情，直到任务进入终态，并且提供商元数据包含已完成的输出。

​
输入角色

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

授权

​
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
必填

Aspect ratio of the output video, e.g. 1280:720.

​
contentModeration
object
必填

响应

200 - application/json

Task accepted.

​
id
string
必填