Skip to main content
POST
cURL
Verwenden Sie diesen Endpoint, um die Performance aus einem Referenzclip auf ein Charakterbild oder Charaktervideo 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

Ausgabeverhältnis

Aufgabenablauf

1

Die Anfrage für die Charakterperformance senden

Erstellen Sie die Aufgabe 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 abfragen

Fahren Sie mit Eine Runway-Task abrufen fort, bis die Aufgabe einen terminalen Zustand erreicht und die Provider-Metadaten die fertige Ausgabe enthalten.

Eingaberollen

  • character ist das Motiv, 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

Requested output frame shape, for example 1280:720 or 720:1280. Keep the character and reference assets close to the requested frame shape.

contentModeration
object
erforderlich

Antwort

200 - application/json

Task accepted.

id
string
erforderlich