Passer au contenu principal
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>"
}
Utilisez ce endpoint pour transférer la performance d’un clip de référence sur une image de personnage ou une vidéo de personnage.

​
Avant de l’appeler

  • Envoyez l’en-tête X-Runway-Version requis, par exemple 2024-11-06
  • Utilisez model: act_two
  • Fournissez une ressource character et une ressource reference sous forme d’URL HTTPS accessibles
  • Commencez avec bodyControl: true et une valeur modérée de expressionIntensity avant d’ajuster le style

​
Flux de tâche

1

Soumettre la requête de performance du personnage

Créez la tâche avec votre ressource de personnage, votre ressource de référence et les paramètres de mouvement.
2

Stocker l’id de tâche renvoyé

Conservez l’id renvoyé, car vous en aurez besoin pour les interrogations ultérieures.
3

Interroger le statut de la tâche

Continuez avec Get Task Details jusqu’à ce que le wrapper atteigne un état terminal et que les métadonnées du fournisseur incluent la sortie finale.

​
Rôles d’entrée

  • character est le sujet que vous souhaitez animer
  • reference est le clip source qui fournit la performance faciale ou le mouvement du corps
  • bodyControl détermine si le transfert de mouvement inclut les mouvements du corps en plus du transfert d’expression
  • contentModeration applique les seuils de modération du fournisseur à la requête

Autorisations

​
Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

En-têtes

​
X-Runway-Version
string
requis

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

Corps

application/json
​
character
object
requis

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

​
reference
object
requis

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

​
bodyControl
boolean
défaut:true
requis

Enable body control.

​
expressionIntensity
integer
défaut:1
requis

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

​
seed
integer
défaut:1
requis

Random seed for reproducible results.

​
model
string
défaut:act_two
requis

The model variant to use. Must be act_two.

​
ratio
string
défaut:1280:720
requis

Aspect ratio of the output video, e.g. 1280:720.

​
contentModeration
object
requis

Réponse

200 - application/json

Task accepted.

​
id
string
requis