Skip to main content
POST
cURL
Use este endpoint para transferir a performance de um clipe de referência para uma imagem de personagem ou 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

Proporção de saída

Fluxo da tarefa

1

Enviar a solicitação de performance de personagem

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

Armazenar o id da tarefa retornado

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

Consultar o status da tarefa

Continue com Obter uma tarefa do Runway até que a tarefa atinja um estado terminal e os metadados do provedor incluam a saída final.

Papéis de entrada

  • character é o sujeito que você deseja animar
  • reference é o clipe de origem que fornece performance facial ou 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

Requested output frame shape, for example 1280:720 or 720:1280. Keep the character and reference assets close to the requested frame shape.

contentModeration
object
obrigatório

Resposta

200 - application/json

Task accepted.

id
string
obrigatório