Referência da API
Guias de Integração
Preços e Faturamento
Formato Oficial
Imagem para Vídeo
Use a CometAPI para chamar o image_to_video do Runway e converter uma URL de imagem estática em saída bruta de vídeo, com suporte a X-Runway-Version para compatibilidade.
POST
/
runwayml
/
v1
/
image_to_video
Create a Runway image-to-video task
curl --request POST \
--url https://api.cometapi.com/runwayml/v1/image_to_video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Runway-Version: <x-runway-version>' \
--data '
{
"promptImage": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
"model": "gen3a_turbo"
}
'{
"id": "3d957031-9a2a-45e2-9dc7-bc8513059c50"
}Use este endpoint para animar uma imagem de origem em um vídeo do Runway.
Antes de chamar
- Envie o cabeçalho obrigatório
X-Runway-Version, por exemplo2024-11-06 - Use
model: gen3a_turbo - Forneça um
promptImageHTTPS estável - Comece com
duration: 5e uma proporção comum, como1280:720
Fluxo da tarefa
Enviar a solicitação de imagem para vídeo
Crie a tarefa com uma imagem de origem e um Prompt curto de movimento opcional.
Consultar o status da tarefa
Use Get Task Details. Se a primeira consulta retornar
task_not_exist, aguarde alguns segundos e tente novamente.A validação em produção em 2026-03-13 confirmou que uma solicitação mínima com
gen3a_turbo foi aceita e retornou um id. Após um curto intervalo, tanto os detalhes oficiais da tarefa quanto o feed reverso retornaram o mesmo status enfileirado encapsulado para essa tarefa.Autorizações
Bearer token authentication. Use your CometAPI key.
Cabeçalhos
Runway version header, for example 2024-11-06.
Corpo
application/json
promptImage
string
padrão:https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg
obrigatório
Source image URL.
Runway image-to-video model ID. Choose a current model from the Models page.
Random seed for reproducible results. Range: 0–999999999.
Text prompt describing the desired motion or scene. Maximum 512 characters.
Whether to add a watermark to the output video.
Video duration in seconds. Accepted values: 5 or 10.
Aspect ratio of the output video.
Opções disponíveis:
1280:720, 720:1280, 1104:832, 832:1104, 960:960, 1584:672, 1280:768, 768:1280 Resposta
200 - application/json
Task accepted.
⌘I
Create a Runway image-to-video task
curl --request POST \
--url https://api.cometapi.com/runwayml/v1/image_to_video \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Runway-Version: <x-runway-version>' \
--data '
{
"promptImage": "https://cdn.britannica.com/70/234870-050-D4D024BB/Orange-colored-cat-yawns-displaying-teeth.jpg",
"model": "gen3a_turbo"
}
'{
"id": "3d957031-9a2a-45e2-9dc7-bc8513059c50"
}