Skip to main content
POST
cURL
Use este endpoint para transformar um clipe de origem existente com o fluxo de trabalho de vídeo para vídeo do Runway. Ele inicia uma tarefa assíncrona em vez de retornar o resultado final imediatamente.

Antes de chamá-lo

  • Prepare um vídeo de origem que atenda aos requisitos de entrada do provedor
  • Inclua o cabeçalho obrigatório X-Runway-Version para o conjunto de recursos que você deseja
  • Comece com um prompt curto que descreva a mudança, não um storyboard completo

Proporção de saída

Este endpoint espera valores de ratio separados por dois-pontos. Use 1280:720 para saída 1280x720 e 720:1280 para 720x1280; 1280x720 não é aceito em todas as rotas Runway de vídeo para vídeo.

Fluxo da tarefa

1

Envie o clipe de origem e o prompt

Inicie a tarefa a partir deste endpoint e salve o id da tarefa retornado.
2

Consulte os detalhes da tarefa

Use Obter uma tarefa do Runway até que a tarefa atinja um estado terminal.
3

Armazene o resultado transformado

Faça o download ou persista o asset finalizado por meio do seu pipeline de mídia normal.

Autorizações

Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Cabeçalhos

X-Runway-Version
string
obrigatório

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

Corpo

application/json
videoUri
string
padrão:https://your-video-host/source.mp4
obrigatório

HTTPS URL of the source video, or a base64 data URI containing the video.

promptText
string
padrão:A cat yawning in slow motion.
obrigatório

Text prompt describing the desired output. Maximum 1000 characters.

seed
integer
padrão:1
obrigatório

Random seed for reproducible results. Range: 0–4294967295.

model
string
padrão:gen4_aleph
obrigatório

Model variant to use.

references
object[]
obrigatório

Optional reference images to guide generation. Each item must include type (e.g. image) and uri (HTTPS URL).

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

Requested output frame shape. Use colon-separated values such as 1280:720 or 720:1280; read them as 1280x720 and 720x1280 targets. Do not assume every Runway video-to-video route accepts 1280x720 with an x separator.

contentModeration
object
obrigatório

Resposta

200 - application/json

success

id
string
obrigatório

The ID of the task that was created. Use this to retrieve the task later.