Styr en karakter

Bruk CometAPI med Runway Control a character API for å starte karakterytelsesoppgaver fra en referansevideo, og styre ansiktsuttrykk og kroppsbevegelse.

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

Bruk dette endepunktet for å overføre ytelse fra et referanseklipp til et karakterbilde eller en karaktervideo.

​

Før du kaller det

• Send den påkrevde X-Runway-Version-headeren, for eksempel 2024-11-06
• Bruk model: act_two
• Oppgi én character-ressurs og én reference-ressurs som tilgjengelige HTTPS-URL-er
• Start med bodyControl: true og en moderat expressionIntensity før du finjusterer stilen

​

Oppgaveflyt

1. Send inn character-performance-forespørselen

   Opprett oppgaven med karakterressursen din, referanseressursen og bevegelsesinnstillingene.

2. Lagre den returnerte task id-en

   Behold den returnerte id, fordi du trenger den for senere polling.

3. Poll oppgavestatus

   Fortsett med Get Task Details til wrapperen når en terminal tilstand og providermetadata inkluderer det ferdige resultatet.

​

Inndataroller

• character er subjektet du vil animere
• reference er kildeklippet som gir ansiktsytelse eller kroppsbevegelse
• bodyControl avgjør om bevegelsesoverføringen inkluderer kroppsbevegelse i tillegg til uttrykksoverføring
• contentModeration bruker providerens modereringsterskler på forespørselen

Autorisasjoner

Authorization · string · header · påkrevd

Bearer token authentication. Use your CometAPI key.

Overskrifter

X-Runway-Version · string · påkrevd

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

Kropp

application/json

character · object · påkrevd

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

Show child attributes

reference · object · påkrevd

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

Show child attributes

bodyControl · boolean · standard: true · påkrevd

Enable body control.

expressionIntensity · integer · standard: 1 · påkrevd

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

seed · integer · standard: 1 · påkrevd

Random seed for reproducible results.

model · string · standard: act_two · påkrevd

The model variant to use. Must be act_two.

ratio · string · standard: 1280:720 · påkrevd

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

contentModeration · object · påkrevd

Show child attributes

Svar

200 - application/json

Task accepted.

id · string · påkrevd