Skip to main content
POST
cURL
Bir referans videosunun performansını bir karakter görseline uygulamak için act_two kullanın veya videoya uygulamak için kullanın. İstek, tamamlanan çıktıyı almak için bir görev id döndürür.

Varlıkları hazırlayın

  • CometAPI API anahtarınızla kimlik doğrulaması yapın.
  • model değerini act_two olarak ayarlayın.
  • Varlık şu konumda olacak şekilde character.type değerini image veya video olarak sağlayın character.uri. Tanınabilir bir yüzü görünür ve çerçevenin içinde tutun.
  • reference.type değerini video olarak, 3 ila 30 saniyelik bir performans klibiyle reference.uri içinde sağlayın.
  • Örnek medya URL’lerini erişilebilir HTTPS URL’leriyle değiştirin. Medya alanları ayrıca kodlanmış boyutu 5 MB’a kadar olan Base64 veri URI’lerini kabul eder.

Performansı yapılandırın

Yalnızca model, character ve reference gereklidir. bodyControl: false atlama olarak değerlendirilir; bu nedenle vücut kontrolünü açıkça devre dışı bırakmaz. seed ya da expressionIntensity için 0 değeri de atlama olarak değerlendirilir. İsteğe bağlı alanları null göndermek yerine atlayın. İsteğe bağlı ratio değerleri 1280:720, 720:1280, 960:960, 1104:832, 832:1104veya 1584:672 olabilir.

Sonucu alın

Döndürülen id değerini kaydedin ve Runway görevi alma işlemini görev durumunu almak için kullanın. status, SUCCEEDED olduğunda, sonuç URL’lerini output içinden okuyun. Görev başarısız olursa, mevcut olduğunda failure ve failureCode öğelerini inceleyin.

Yetkilendirmeler

Authorization
string
header
gerekli

Your CometAPI API key.

Gövde

application/json

Act-Two character-performance request.

model
enum<string>
gerekli

Model ID for this request.

Mevcut seçenekler:
act_two
character
object
gerekli

Character image or video to animate. Keep a recognizable face visible and inside the frame.

reference
object
gerekli

Reference video containing the performance to apply. The video must be 3 to 30 seconds long.

bodyControl
boolean

Set true to request body movements and gestures in addition to facial expressions. Omit to leave this option unspecified; false is treated as omission.

expressionIntensity
integer

Expression intensity from 1 through 5. Higher values request stronger expressions. Omit for 3; 0 is treated as omission.

Gerekli aralık: 0 <= x <= 5
seed
integer

Sampling seed. Omit for a random seed; 0 is treated as omission.

Gerekli aralık: 0 <= x <= 4294967295
ratio
enum<string>

Optional requested frame dimensions.

Mevcut seçenekler:
1280:720,
720:1280,
960:960,
1104:832,
832:1104,
1584:672
contentModeration
object

Content moderation settings. Omit to use the standard settings.

Yanıt

The task was created. Save its id for task retrieval.

id
string
gerekli

Task ID for GET /runwayml/v1/tasks/{id}.

status
string

Task state, when returned.

createdAt
string<date-time>

Task submission timestamp, when returned.

output
string<uri>[]

Result URLs, when returned.

failure
string

Failure explanation, when returned.

failureCode
string

Machine-readable failure code, when returned.

estimatedCost
object

Task estimate metadata, when returned.

cost
object

Task cost metadata, when returned.

Son değiştirilme tarihi 18 Eylül 2026