Skip to main content
POST
cURL
Usa questo endpoint per trasferire la performance da una clip di riferimento su un’immagine del personaggio o un video del personaggio.

Prima di chiamarlo

  • Invia l’header X-Runway-Version richiesto, ad esempio 2024-11-06
  • Usa model: act_two
  • Fornisci una risorsa character e una risorsa reference come URL HTTPS accessibili
  • Inizia con bodyControl: true e un valore moderato di expressionIntensity prima di regolare lo stile

Rapporto di output

Flusso del task

1

Invia la richiesta di character performance

Crea il task con la tua risorsa character, la risorsa reference e le impostazioni di movimento.
2

Memorizza l'id del task restituito

Conserva l’id restituito, perché ti servirà per il polling successivo.
3

Esegui il polling dello stato del task

Continua con Ottenere un task Runway finché il task non raggiunge uno stato terminale e i metadati del provider non includono l’output completato.

Ruoli di input

  • character è il soggetto che vuoi animare
  • reference è la clip sorgente che fornisce la performance facciale o il movimento del corpo
  • bodyControl decide se il trasferimento del movimento include il movimento del corpo oltre al trasferimento dell’espressione
  • contentModeration applica le soglie di moderazione del provider alla richiesta

Autorizzazioni

Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Intestazioni

X-Runway-Version
string
obbligatorio

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

Corpo

application/json
character
object
obbligatorio

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

reference
object
obbligatorio

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

bodyControl
boolean
predefinito:true
obbligatorio

Enable body control.

expressionIntensity
integer
predefinito:1
obbligatorio

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

seed
integer
predefinito:1
obbligatorio

Random seed for reproducible results.

model
string
predefinito:act_two
obbligatorio

The model variant to use. Must be act_two.

ratio
string
predefinito:1280:720
obbligatorio

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
obbligatorio

Risposta

200 - application/json

Task accepted.

id
string
obbligatorio