Bir Karakteri Kontrol Etme

CometAPI ile Runway Control a character API kullanarak bir referans videodan karakter performansı görevleri başlatın; yüz ifadelerini ve vücut hareketlerini yönlendirin.

POST /runwayml/v1/character_performance

Create a Runway character-performance task

cURL

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"
  }
}
'

200

{
  "id": "<string>"
}

Bu endpoint’i, bir referans klipteki performansı bir karakter görseline veya karakter videosuna aktarmak için kullanın.

​

Çağırmadan önce

• Gerekli X-Runway-Version header’ını gönderin, örneğin 2024-11-06
• model: act_two kullanın
• Erişilebilir HTTPS URL’leri olarak bir character asset’i ve bir reference asset’i sağlayın
• Stili ince ayarlamadan önce bodyControl: true ve orta düzeyde bir expressionIntensity ile başlayın

​

Görev akışı

1. Karakter performansı isteğini gönderin

   Karakter asset’iniz, referans asset’iniz ve hareket ayarlarınızla görevi oluşturun.

2. Döndürülen görev kimliğini saklayın

   Döndürülen id değerini saklayın; çünkü daha sonra polling için buna ihtiyacınız olacak.

3. Görev durumunu sorgulayın

   Wrapper terminal bir duruma ulaşana ve sağlayıcı metadata’sı tamamlanmış çıktıyı içerene kadar Get Task Details ile devam edin.

​

Girdi rolleri

• character, canlandırmak istediğiniz özneyi ifade eder
• reference, yüz performansını veya vücut hareketini sağlayan kaynak kliptir
• bodyControl, hareket aktarımının ifade aktarımına ek olarak vücut hareketini de içerip içermeyeceğini belirler
• contentModeration, isteğe sağlayıcının moderasyon eşiklerini uygular

Yetkilendirmeler

Authorization · string · header · gerekli

Bearer token authentication. Use your CometAPI key.

Başlıklar

X-Runway-Version · string · gerekli

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

Gövde

application/json

character · object · gerekli

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

Show child attributes

reference · object · gerekli

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

Show child attributes

bodyControl · boolean · varsayılan: true · gerekli

Enable body control.

expressionIntensity · integer · varsayılan: 1 · gerekli

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

seed · integer · varsayılan: 1 · gerekli

Random seed for reproducible results.

model · string · varsayılan: act_two · gerekli

The model variant to use. Must be act_two.

ratio · string · varsayılan: 1280:720 · gerekli

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

contentModeration · object · gerekli

Show child attributes

Yanıt

200 - application/json

Task accepted.

id · string · gerekli