Saltar para o conteúdo principal
POST
/
runwayml
/
v1
/
video_to_video
Generate a video from a video
curl --request POST \
  --url https://api.cometapi.com/runwayml/v1/video_to_video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Runway-Version: <x-runway-version>' \
  --data '
{
  "videoUri": "https://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.mp4",
  "promptText": "string",
  "seed": 4294967295,
  "model": "gen4_aleph",
  "references": [
    {
      "type": "image",
      "uri": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg"
    }
  ],
  "ratio": "1280:720",
  "contentModeration": {
    "publicFigureThreshold": "auto"
  }
}
'
{}
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 imediatamente a saída final.

​
Antes de chamar

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

​
Fluxo da tarefa

1

Enviar o clipe de origem e o prompt

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

Consultar detalhes da tarefa

Use Runway to Get Task Details até que a tarefa atinja um estado terminal.
3

Armazenar o resultado transformado

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

​
Observação sobre o wrapper do CometAPI

O CometAPI mantém o modelo de tarefas assíncronas e o comportamento de requisições versionadas do Runway, mas unifica a autenticação e o tratamento da URL base com o restante da plataforma.

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://filesystem.site/cdn/20250818/c4gCDVPhiBc6TomRTJ7zNg0KwO1PSJ.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

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

​
contentModeration
object
obrigatório

Resposta

200 - application/json

success

The response is of type object.