Zum Hauptinhalt springen
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>"
}
Verwenden Sie diesen Endpunkt, um die Performance aus einem Referenzclip auf ein Figurenbild oder ein Figurenvideo 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

Die Character-Performance-Anfrage absenden

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

Die zurückgegebene Task-ID speichern

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

Task-Status pollen

Fahren Sie mit Get Task Details fort, bis der Wrapper einen Endzustand 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 Gesichtsperformance 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.

​
reference
object
erforderlich

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

​
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

Antwort

200 - application/json

Task accepted.

​
id
string
erforderlich