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": "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.

Sử dụng endpoint này để chuyển hiệu suất trình diễn từ một clip tham chiếu sang một 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 nhân vật, asset tham chiếu và các cài đặt 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 này.
3

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

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

​
Vai trò đầu vào

  • character là đối tượng bạn muốn tạo chuyển động
  • reference là clip nguồn cung cấp phần trình diễn khuôn mặt hoặc chuyển động cơ thể
  • bodyControl quyết định việc chuyển 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 nhà cung cấp 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