Saltar para o conteúdo 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.

Use este endpoint para transferir a performance de um clipe de referência para uma imagem de personagem ou um vídeo de personagem.

​
Antes de chamá-lo

  • Envie o cabeçalho X-Runway-Version obrigatório, por exemplo 2024-11-06
  • Use model: act_two
  • Forneça um asset character e um asset reference como URLs HTTPS acessíveis
  • Comece com bodyControl: true e um expressionIntensity moderado antes de ajustar o estilo

​
Fluxo da tarefa

1

Envie a solicitação de performance do personagem

Crie a tarefa com seu asset de personagem, asset de referência e configurações de movimento.
2

Armazene o id da tarefa retornado

Mantenha o id retornado, porque você precisará dele para consultas posteriores.
3

Consulte o status da tarefa

Continue com Obter detalhes da tarefa até que a tarefa alcance um estado terminal e os metadados do provedor incluam a saída concluída.

​
Papéis de entrada

  • character é o sujeito que você deseja animar
  • reference é o clipe de origem que fornece a performance facial ou o movimento corporal
  • bodyControl decide se a transferência de movimento inclui movimento corporal além da transferência de expressão
  • contentModeration aplica os limites de moderação do provedor à solicitação

Autorizações

​
Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Cabeçalhos

​
X-Runway-Version
string
obrigatório

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

Corpo

application/json
​
character
object
obrigatório

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

​
reference
object
obrigatório

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

​
bodyControl
boolean
padrão:true
obrigatório

Enable body control.

​
expressionIntensity
integer
padrão:1
obrigatório

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

​
seed
integer
padrão:1
obrigatório

Random seed for reproducible results.

​
model
string
padrão:act_two
obrigatório

The model variant to use. Must be act_two.

​
ratio
string
padrão:1280:720
obrigatório

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

​
contentModeration
object
obrigatório

Resposta

200 - application/json

Task accepted.

​
id
string
obrigatório