Een personage besturen

Gebruik CometAPI met de Runway Control a character API om character performance-taken te starten vanuit een referentievideo, waarbij gezichtsuitdrukkingen en lichaamsbewegingen worden aangestuurd.

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

Gebruik dit endpoint om performance van een referentieclip over te zetten op een personageafbeelding of personagevideo.

​

Voordat je het aanroept

• Verstuur de vereiste X-Runway-Version header, bijvoorbeeld 2024-11-06
• Gebruik model: act_two
• Geef één character-asset en één reference-asset op als toegankelijke HTTPS-URL’s
• Begin met bodyControl: true en een gematigde expressionIntensity voordat je de stijl afstemt

​

Taakverloop

1. Dien het character-performance-verzoek in

   Maak de taak aan met je character-asset, reference-asset en bewegingsinstellingen.

2. Sla de geretourneerde task id op

   Bewaar de geretourneerde id, want die heb je later nodig voor polling.

3. Poll de taakstatus

   Ga verder met Get Task Details totdat de wrapper een terminale status bereikt en provider-metadata de voltooide output bevat.

​

Invoerrollen

• character is het onderwerp dat je wilt animeren
• reference is de bronclip die gezichtsperformance of lichaamsbeweging levert
• bodyControl bepaalt of motion transfer naast expressieoverdracht ook lichaamsbeweging omvat
• contentModeration past provider-moderatiedrempels toe op het verzoek

Autorisaties

Authorization · string · header · vereist

Bearer token authentication. Use your CometAPI key.

Headers

X-Runway-Version · string · vereist

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

Body

application/json

character · object · vereist

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

Show child attributes

reference · object · vereist

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

Show child attributes

bodyControl · boolean · standaard: true · vereist

Enable body control.

expressionIntensity · integer · standaard: 1 · vereist

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

seed · integer · standaard: 1 · vereist

Random seed for reproducible results.

model · string · standaard: act_two · vereist

The model variant to use. Must be act_two.

ratio · string · standaard: 1280:720 · vereist

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

contentModeration · object · vereist

Show child attributes

Respons

200 - application/json

Task accepted.

id · string · vereist