Skip to main content
POST
cURL
Utilisez act_two pour appliquer la performance d’une vidéo de référence à l’image d’un personnage ou à une vidéo. La requête renvoie un identifiant de tâche id permettant de récupérer le résultat final.

Préparer les ressources

  • Authentifiez-vous avec votre clé API CometAPI.
  • Définissez model sur act_two.
  • Fournissez character.type sous forme de image ou de video, avec la ressource au format character.uri. Gardez un visage reconnaissable visible et dans le cadre.
  • Fournissez reference.type sous forme de video, avec un clip de performance de 3 à 30 secondes au format reference.uri.
  • Remplacez les URL de médias d’exemple par des URL HTTPS accessibles. Les champs de médias acceptent également des URI de données Base64 dont la taille encodée peut atteindre 5 Mo.

Configurer la performance

Seuls model, character et reference sont obligatoires. bodyControl: false est traité comme une omission et ne désactive donc pas explicitement le contrôle du corps. Une valeur de seed ou de expressionIntensity égale à 0 est également traitée comme une omission. Omettez les champs facultatifs au lieu d’envoyer null. Les valeurs facultatives de ratio sont 1280:720, 720:1280, 960:960, 1104:832, 832:1104, ou 1584:672.

Récupérer le résultat

Enregistrez le id renvoyé et utilisez Récupérer une tâche Runway pour récupérer l’état de la tâche. Lorsque status vaut SUCCEEDED, lisez les URL du résultat dans output. Si la tâche échoue, examinez failure et failureCode lorsqu’ils sont présents.

Autorisations

Authorization
string
header
requis

Your CometAPI API key.

Corps

application/json

Act-Two character-performance request.

model
enum<string>
requis

Model ID for this request.

Options disponibles:
act_two
character
object
requis

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

reference
object
requis

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.

Plage requise: 0 <= x <= 5
seed
integer

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

Plage requise: 0 <= x <= 4294967295
ratio
enum<string>

Optional requested frame dimensions.

Options disponibles:
1280:720,
720:1280,
960:960,
1104:832,
832:1104,
1584:672
contentModeration
object

Content moderation settings. Omit to use the standard settings.

Réponse

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

id
string
requis

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.

Dernière modification le 18 septembre 2026