Skip to main content
POST
cURL
Sử dụng endpoint này để chuyển performance 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: trueexpressionIntensity ở mức vừa phải trước khi tinh chỉnh phong cách

Tỷ lệ đầu ra

Luồng tác vụ

1

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

Tạo tác vụ bằng 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 về sau.
3

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

Tiếp tục với Lấy một tác vụ Runway 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 đầ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 performance 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 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

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
bắt buộc

Phản hồi

200 - application/json

Task accepted.

id
string
bắt buộc