Ana içeriğe atla
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>"
}
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.

​
reference
object
gerekli

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

​
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

Yanıt

200 - application/json

Task accepted.

​
id
string
gerekli