Eine Figur steuern

Verwenden Sie CometAPI mit der Runway Control a character API, um Character-Performance-Tasks aus einem Referenzvideo zu starten und dabei Gesichtsausdrücke und Körperbewegungen zu steuern.

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

Verwenden Sie diesen Endpoint, um die Performance aus einem Referenzclip auf ein Character-Bild oder Character-Video zu übertragen.

​

Bevor Sie ihn aufrufen

• Senden Sie den erforderlichen Header X-Runway-Version, zum Beispiel 2024-11-06
• Verwenden Sie model: act_two
• Geben Sie ein character-Asset und ein reference-Asset als erreichbare HTTPS-URLs an
• Beginnen Sie mit bodyControl: true und einer moderaten expressionIntensity, bevor Sie den Stil feinabstimmen

​

Task-Ablauf

1. Senden Sie die Character-Performance-Anfrage

   Erstellen Sie den Task mit Ihrem character-Asset, reference-Asset und den Bewegungseinstellungen.

2. Speichern Sie die zurückgegebene Task-ID

   Bewahren Sie die zurückgegebene id auf, da Sie sie später für das Polling benötigen.

3. Fragen Sie den Task-Status ab

   Fahren Sie mit Get Task Details fort, bis der Task einen terminalen Zustand erreicht und die Provider-Metadaten die fertige Ausgabe enthalten.

​

Eingaberollen

• character ist das Subjekt, das Sie animieren möchten
• reference ist der Quellclip, der die Gesichts-Performance oder Körperbewegung liefert
• bodyControl legt fest, ob die Bewegungsübertragung zusätzlich zur Ausdrucksübertragung auch Körperbewegungen umfasst
• contentModeration wendet die Moderationsschwellen des Providers auf die Anfrage an

Autorisierungen

Authorization · string · header · erforderlich

Bearer token authentication. Use your CometAPI key.

Header

X-Runway-Version · string · erforderlich

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

Body

application/json

character · object · erforderlich

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

Show child attributes

reference · object · erforderlich

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

Show child attributes

bodyControl · boolean · Standard: true · erforderlich

Enable body control.

expressionIntensity · integer · Standard: 1 · erforderlich

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

seed · integer · Standard: 1 · erforderlich

Random seed for reproducible results.

model · string · Standard: act_two · erforderlich

The model variant to use. Must be act_two.

ratio · string · Standard: 1280:720 · erforderlich

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

contentModeration · object · erforderlich

Show child attributes

Antwort

200 - application/json

Task accepted.

id · string · erforderlich