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": "5b91e444-c232-deaf-a4d7-8aef3e57336b"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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’URLs 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 Obtenir les détails de la tâche jusqu’à ce que la tâche 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