Chuyển đến nội dung chính
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": "<string>"
}
Sử dụng endpoint này để chuyển hiệu suất biểu diễn từ một clip tham chiếu sang hình ảnh nhân vật hoặc video nhân vật.

​
Trước khi gọi

  • Gửi header X-Runway-Version bắt buộc, ví dụ 2024-11-06
  • Sử dụng model: act_two
  • Cung cấp một asset character và một asset reference dưới dạng URL HTTPS có thể truy cập được
  • Bắt đầu với bodyControl: true và expressionIntensity ở mức vừa phải trước khi tinh chỉnh phong cách

​
Luồng tác vụ

1

Gửi yêu cầu character-performance

Tạo tác vụ với asset character, asset reference và các thiết lập chuyển động của bạn.
2

Lưu task id được trả về

Giữ lại id được trả về, vì bạn sẽ cần nó để polling sau đó.
3

Polling trạng thái tác vụ

Tiếp tục với Get Task Details cho đến khi wrapper đạt trạng thái kết thúc và metadata của provider bao gồm đầu ra đã hoàn tất.

​
Vai trò đầu vào

  • character là đối tượng bạn muốn tạo animation
  • reference là clip nguồn cung cấp biểu diễn khuôn mặt hoặc chuyển động cơ thể
  • bodyControl quyết định liệu việc chuyển động có bao gồm chuyển động cơ thể ngoài việc chuyển biểu cảm hay không
  • contentModeration áp dụng các ngưỡng kiểm duyệt của provider cho yêu cầu

Ủy quyền

​
Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Tiêu đề

​
X-Runway-Version
string
bắt buộc

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

Nội dung

application/json
​
character
object
bắt buộc

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

​
reference
object
bắt buộc

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

​
bodyControl
boolean
mặc định:true
bắt buộc

Enable body control.

​
expressionIntensity
integer
mặc định:1
bắt buộc

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

​
seed
integer
mặc định:1
bắt buộc

Random seed for reproducible results.

​
model
string
mặc định:act_two
bắt buộc

The model variant to use. Must be act_two.

​
ratio
string
mặc định:1280:720
bắt buộc

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

​
contentModeration
object
bắt buộc

Phản hồi

200 - application/json

Task accepted.

​
id
string
bắt buộc