Mengontrol Karakter

Gunakan CometAPI dengan API Runway Control a character untuk memulai tugas performa karakter dari video referensi, menggerakkan ekspresi wajah dan gerakan tubuh.

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

Gunakan endpoint ini untuk mentransfer performa dari klip referensi ke gambar karakter atau video karakter.

​

Sebelum Anda memanggilnya

• Kirim header X-Runway-Version yang wajib, misalnya 2024-11-06
• Gunakan model: act_two
• Sediakan satu aset character dan satu aset reference sebagai URL HTTPS yang dapat diakses
• Mulailah dengan bodyControl: true dan expressionIntensity yang moderat sebelum menyesuaikan style

​

Alur tugas

1. Kirim permintaan character-performance

   Buat tugas dengan aset karakter, aset referensi, dan pengaturan gerakan Anda.

2. Simpan task id yang dikembalikan

   Simpan id yang dikembalikan, karena Anda akan membutuhkannya untuk polling nanti.

3. Poll status tugas

   Lanjutkan dengan Get Task Details sampai wrapper mencapai status terminal dan metadata provider menyertakan output akhir.

​

Peran input

• character adalah subjek yang ingin Anda animasikan
• reference adalah klip sumber yang menyediakan performa wajah atau gerakan tubuh
• bodyControl menentukan apakah transfer gerakan mencakup gerakan tubuh selain transfer ekspresi
• contentModeration menerapkan ambang moderasi provider pada permintaan

Otorisasi

Authorization · string · header · wajib

Bearer token authentication. Use your CometAPI key.

Header

X-Runway-Version · string · wajib

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

Body

application/json

character · object · wajib

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

Show child attributes

reference · object · wajib

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

Show child attributes

bodyControl · boolean · default: true · wajib

Enable body control.

expressionIntensity · integer · default: 1 · wajib

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

seed · integer · default: 1 · wajib

Random seed for reproducible results.

model · string · default: act_two · wajib

The model variant to use. Must be act_two.

ratio · string · default: 1280:720 · wajib

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

contentModeration · object · wajib

Show child attributes

Respons

200 - application/json

Task accepted.

id · string · wajib