Skip to main content
POST
cURL
Usa act_two per applicare la performance di un video di riferimento a un’immagine del personaggio o a un video. La richiesta restituisce un id del task per recuperare l’output completato.

Prepara le risorse

  • Autenticati con la tua chiave API CometAPI.
  • Imposta model su act_two.
  • Fornisci character.type come image o video, con la risorsa in character.uri. Mantieni un volto riconoscibile visibile e all’interno dell’inquadratura.
  • Fornisci reference.type come video, con una clip di performance da 3 a 30 secondi in reference.uri.
  • Sostituisci gli URL multimediali di esempio con URL HTTPS accessibili. I campi multimediali accettano anche URI di dati Base64 con dimensioni codificate fino a 5 MB.

Configura la performance

Sono obbligatori solo model, character e reference. bodyControl: false viene trattato come omissione, quindi non disabilita esplicitamente il controllo del corpo. Anche un valore seed o expressionIntensity pari a 0 viene trattato come omissione. Ometti i campi facoltativi invece di inviare null. I valori facoltativi di ratio sono 1280:720, 720:1280, 960:960, 1104:832, 832:1104, o 1584:672.

Recupera il risultato

Salva il valore id restituito e usa Ottieni un task Runway per recuperare lo stato del task. Quando status è SUCCEEDED, leggi gli URL del risultato da output. Se il task non riesce, controlla failure e failureCode quando presenti.

Autorizzazioni

Authorization
string
header
obbligatorio

Your CometAPI API key.

Corpo

application/json

Act-Two character-performance request.

model
enum<string>
obbligatorio

Model ID for this request.

Opzioni disponibili:
act_two
character
object
obbligatorio

Character image or video to animate. Keep a recognizable face visible and inside the frame.

reference
object
obbligatorio

Reference video containing the performance to apply. The video must be 3 to 30 seconds long.

bodyControl
boolean

Set true to request body movements and gestures in addition to facial expressions. Omit to leave this option unspecified; false is treated as omission.

expressionIntensity
integer

Expression intensity from 1 through 5. Higher values request stronger expressions. Omit for 3; 0 is treated as omission.

Intervallo richiesto: 0 <= x <= 5
seed
integer

Sampling seed. Omit for a random seed; 0 is treated as omission.

Intervallo richiesto: 0 <= x <= 4294967295
ratio
enum<string>

Optional requested frame dimensions.

Opzioni disponibili:
1280:720,
720:1280,
960:960,
1104:832,
832:1104,
1584:672
contentModeration
object

Content moderation settings. Omit to use the standard settings.

Risposta

The task was created. Save its id for task retrieval.

id
string
obbligatorio

Task ID for GET /runwayml/v1/tasks/{id}.

status
string

Task state, when returned.

createdAt
string<date-time>

Task submission timestamp, when returned.

output
string<uri>[]

Result URLs, when returned.

failure
string

Failure explanation, when returned.

failureCode
string

Machine-readable failure code, when returned.

estimatedCost
object

Task estimate metadata, when returned.

cost
object

Task cost metadata, when returned.

Ultima modifica il 18 settembre 2026