Referência da API
Guias de Integração
Preços e Faturamento
Controlar um Personagem
Use o CometAPI com a API Control a character da Runway para iniciar tarefas de performance de personagem a partir de um vídeo de referência, controlando expressões faciais e movimento corporal.
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>"
}Antes de chamar
- Envie o cabeçalho obrigatório
X-Runway-Version, por exemplo2024-11-06 - Use
model: act_two - Forneça um asset
charactere um assetreferencecomo URLs HTTPS acessíveis - Comece com
bodyControl: truee umexpressionIntensitymoderado antes de ajustar o estilo
Fluxo da tarefa
Envie a solicitação de performance do personagem
Armazene o id da tarefa retornado
id retornado, porque você precisará dele para consultar o status depois.Consulte o status da tarefa
Papéis de entrada
characteré o sujeito que você deseja animarreferenceé o clipe de origem que fornece a performance facial ou o movimento corporalbodyControldefine se a transferência de movimento inclui movimento corporal além da transferência de expressãocontentModerationaplica os limites de moderação do provider à solicitação
Autorizações
Bearer token authentication. Use your CometAPI key.
Cabeçalhos
Runway version header, for example 2024-11-06.
Corpo
The character to control. You can either provide a video or an image.
Show child attributes
Show child attributes
Reference performance clip. Provide type (video) and uri (HTTPS URL).
Show child attributes
Show child attributes
Enable body control.
Intensity of the expression transfer. Higher values produce more exaggerated expressions.
Random seed for reproducible results.
The model variant to use. Must be act_two.
Aspect ratio of the output video, e.g. 1280:720.
Show child attributes
Show child attributes
Resposta
Task accepted.
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>"
}