Configuração da API de Vídeo da Runway
A Runway é uma plataforma de geração de vídeo. Geralmente não é uma Base URL para preencher no Chatbox. Em vez disso, crie uma API Key na plataforma da Runway e use o SDK oficial ou requisições HTTP para criar tarefas de vídeo.
Informações oficiais Downloads e documentação estão sujeitos ao site oficial.
Para quais cenários é indicado
Texto para vídeoImagem para vídeoTarefas assíncronasSDK oficial
Primeiro entenda o fluxo de trabalho de tarefas de vídeo
- Crie uma API Key e certifique-se de que sua conta tenha permissões para a API de vídeo e saldo disponível.
- Selecione o tipo de tarefa: texto para vídeo, imagem para vídeo ou outras tarefas de vídeo atualmente suportadas pela documentação oficial.
- Você não receberá o arquivo de vídeo imediatamente após enviar a tarefa; geralmente, receberá primeiro um objeto de tarefa ou ID de tarefa.
- Aguarde a conclusão da tarefa e então leia a URL de saída ou baixe os resultados.
- Em caso de falha, primeiro verifique o status da tarefa e os detalhes do erro; não verifique apenas a Key.
Preparar parâmetros
| Item de configuração | Método de preenchimento |
|---|---|
| API Key | Criação no painel da Runway; o SDK oficial lê <code>RUNWAYML_API_SECRET</code> por padrão |
| Task | texto para vídeo / imagem para vídeo |
| Prompt | Descrição do conteúdo do vídeo |
| Ratio / Size | Paisagem, retrato ou tamanho especificado |
| Duration | Duração do vídeo |
| Status | Fazer polling da tarefa até a conclusão |
| Configuração | Descrição | Dicas para iniciantes |
|---|---|---|
| API Key | Credencial de requisição para a API da Runway | Salve apenas em variáveis de ambiente na máquina local ou no servidor, usando o nome de variável RUNWAYML_API_SECRET |
| Prompt | Descrição do conteúdo do vídeo | Comece escrevendo algo mais curto e depois refine após confirmar o estilo |
| Image | A imagem inicial para imagem para vídeo | Envie imagens nítidas e com um objeto principal bem definido |
| Duration | Segundos do vídeo | Teste primeiro o custo e o resultado com durações mais curtas |
| Status | Status da tarefa | A geração de vídeo é assíncrona e exige aguardar a conclusão. |
Exemplo de SDK
Nome da variável de ambiente da Runway
RUNWAYML_API_SECRET=YOUR_RUNWAY_API_KEYExemplo de tarefa em Node.js da Runway
import RunwayML, { TaskFailedError } from "@runwayml/sdk"; const client = new RunwayML(); try { const task = await client.imageToVideo.create({ model: "gen4.5", promptText: "A product introduction video on a white background with a slow camera push-in", ratio: "1280:720", duration: 5 }).waitForTaskOutput(); console.log(task.output[0]); } catch (error) { if (error instanceof TaskFailedError) { console.error(error.taskDetails); } }Os campos da plataforma de vídeo são atualizados de acordo com a versão do modelo. O exemplo desta página serve para entender a estrutura de configuração; consulte a versão atual da documentação oficial para verificar os campos exatos.
| Problema | Verificação prioritária | Como resolver |
|---|---|---|
| O vídeo não é retornado imediatamente após o envio | A tarefa ainda está na fila ou sendo gerada? | A geração de vídeo é uma tarefa assíncrona; aguarde até que o status seja concluído antes de obter o resultado. |
| Falha na tarefa | Nome do modelo, proporção, duração e se a imagem de entrada atende aos requisitos do modelo atual | Ajuste os parâmetros de acordo com os detalhes do erro retornado e evite alterar muitos itens de uma só vez. |
| As cobranças estão mais altas do que o esperado | Duração, resolução, versão do modelo | Faça testes prévios com curta duração e parâmetros de menor custo antes de gerar em lote |