runway_video

Especificações técnicas de runway-video

O que é runway-video?

runway-video é o identificador de plataforma da CometAPI para acessar as capacidades de geração de vídeo da Runway por meio de uma API unificada. Com base na documentação oficial da API da Runway, a Runway oferece vários modelos de vídeo para gerar clipes a partir de prompts de texto ou de imagens, com endpoints baseados em tarefas para iniciar gerações e posteriormente recuperar os resultados.

Na prática, runway-video deve ser entendido como um gateway para fluxos de criação de vídeo com tecnologia Runway, em vez de um único nome de modelo de base independente. O catálogo atual da API da Runway inclui diversos modelos de vídeo com diferentes modos de entrada e faixas de preço, como gen4.5 para texto ou imagem para vídeo, gen4_turbo para imagem para vídeo, além de opções como gen4_aleph, veo3, veo3.1, veo3.1_fast e gen3a_turbo.

Isso torna runway-video adequado para aplicações como prototipagem criativa, geração de conteúdo de marketing, produção de clipes para redes sociais, visualização de conceitos e experiências de produto que precisam de síntese de vídeo automatizada de curta duração. Como a API subjacente da Runway usa jobs assíncronos, as integrações normalmente enviam primeiro uma solicitação de geração e depois consultam periodicamente ou recuperam a saída da tarefa quando o processamento termina.

Principais recursos de runway-video

• Geração de texto para vídeo: A Runway oferece criação de vídeo a partir de prompts em linguagem natural nos modelos compatíveis, permitindo que desenvolvedores gerem clipes diretamente a partir de descrições de texto.
• Fluxos de trabalho de imagem para vídeo: Vários modelos de vídeo da Runway aceitam entradas de imagem, tornando runway-video útil para animar imagens estáticas ou construir pipelines de geração de vídeo guiados por referências.
• Múltiplas opções de modelos subjacentes: A API da Runway expõe diversos modelos de vídeo com diferentes capacidades e perfis de custo, oferecendo flexibilidade para otimizar por qualidade, velocidade ou orçamento.
• Processamento assíncrono baseado em tarefas: As solicitações de geração criam tarefas em vez de retornarem a mídia final imediatamente, o que é adequado para ambientes de produção que precisam de fila, novas tentativas e verificação de status.
• Uploads temporários de ativos: A Runway fornece endpoints de upload que retornam referências runwayUri, facilitando o envio de imagens, vídeo ou áudio em solicitações de geração posteriores.
• Suporte a SDKs oficiais: A Runway oferece SDKs de Node.js e Python, que podem simplificar a autenticação, a construção de solicitações e a recuperação de resultados.
• Integração com API versionada: As solicitações exigem um cabeçalho explícito X-Runway-Version, o que ajuda os desenvolvedores a trabalharem com um contrato de API conhecido.
• Preços baseados em créditos: A Runway cobra a geração de vídeo por créditos por segundo, com preços variando de acordo com o modelo selecionado.

Como acessar e integrar runway-video

Etapa 1: Inscreva-se para obter uma chave de API

Para acessar runway-video, primeiro crie uma conta e gere uma chave de API pelo seu painel da CometAPI. Após entrar, copie sua chave de API e armazene-a com segurança em uma variável de ambiente ou em um gerenciador de segredos para uso em produção.

Etapa 2: Envie solicitações para a API runway-video

Use sua chave de API para autenticar solicitações ao endpoint da CometAPI para runway-video. Passe seu prompt e quaisquer parâmetros de entrada compatíveis no corpo da solicitação e especifique o modelo como runway-video.

curl -X POST "https://api.cometapi.com/v1/responses" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "runway-video",
    "input": "Create a cinematic video of a futuristic city at sunrise with slow camera movement."
  }'

Etapa 3: Recupere e verifique os resultados

Após o envio, inspecione a resposta da API para obter a saída gerada, o identificador da tarefa ou o payload de resultado retornado para runway-video. Se a geração for assíncrona, consulte periodicamente o endpoint relevante da CometAPI até a conclusão do processamento; em seguida, valide a URL do vídeo retornado, os metadados e o conteúdo antes de usá-los em sua aplicação.