Especificações técnicas de runwayml-image-to-video
| Specification | Details |
|---|---|
| ID do modelo | runwayml-image-to-video |
| Provedor | Runway |
| Capacidade principal | Gera vídeo a partir de uma imagem inicial usando um prompt de texto e geração de movimento condicionada à imagem. |
| Tipo de tarefa da API | Tarefa assíncrona de geração de imagem para vídeo iniciada via endpoint de imagem para vídeo da Runway. |
| Modelos subjacentes compatíveis na API da Runway | O endpoint de imagem para vídeo da Runway aceita vários modelos de vídeo, incluindo gen4_turbo, gen3a_turbo, veo3.1, veo3.1_fast e veo3. |
| Entradas obrigatórias | Uma imagem de entrada mais parâmetros de geração específicos do modelo; o texto do prompt é comumente usado para descrever o movimento e o comportamento da cena. |
| Autenticação | Chave de API do tipo Bearer no cabeçalho Authorization. |
| Cabeçalho de versionamento | A referência da API da Runway exige o cabeçalho X-Runway-Version, com o valor documentado 2024-11-06 para o endpoint de imagem para vídeo. |
| Formato de saída | Ativo de vídeo gerado retornado por meio de processamento de API baseado em tarefas. |
| Taxa de quadros típica | A documentação da Runway lista 24 fps para saídas de imagem para vídeo do Gen-3 Alpha. |
| Resolução de saída comum | A Runway documenta 1280×768 para Gen-3 Alpha e 1280×768 e 768×1280 para Gen-3 Alpha Turbo, dependendo da orientação. |
| Orientações para entrada de imagem | A Runway recomenda evitar imagens de referência menores que 640×640 px ou maiores que 4K para entradas de imagem. |
| Padrão de uso na CometAPI | Acessado por meio da CometAPI usando o identificador de modelo da plataforma runwayml-image-to-video. |
O que é runwayml-image-to-video?
runwayml-image-to-video é o identificador de modelo da CometAPI para acessar a capacidade de geração de imagem para vídeo da Runway. Na prática, essa categoria de modelo usa uma imagem estática como ponto de partida visual e a transforma em um vídeo gerado, normalmente guiado por um prompt de texto que descreve o movimento, o comportamento da câmera, a atmosfera ou a evolução da cena.
A Runway posiciona imagem para vídeo como parte de sua pilha mais ampla de geração de vídeo. Sua documentação do Gen-3 Alpha descreve imagem para vídeo como uma forma de animar uma imagem fornecida, com prompts voltados especialmente para o movimento, em vez de re-descrever tudo o que já está visível no quadro.
Do ponto de vista da API, a Runway expõe a geração de imagem para vídeo como um endpoint de criação de tarefas, o que significa que as solicitações normalmente iniciam um job primeiro e depois exigem etapas de polling ou recuperação para obter o resultado final do vídeo após a conclusão do processamento.
Principais recursos de runwayml-image-to-video
- Geração de vídeo condicionada à imagem: Começa a partir de uma imagem estática e gera um vídeo orientado por movimento, em vez de criar vídeo apenas a partir de texto.
- Controle de movimento guiado por prompt: Funciona melhor quando os prompts descrevem movimento, deslocamento de câmera e mudanças de cena para animar o quadro fornecido de forma coerente.
- Fluxo de trabalho assíncrono de tarefas: Usa uma solicitação de início de geração seguida de recuperação de resultados, o que se adequa a sistemas de produção que enfileiram e monitoram jobs de mídia de longa duração.
- Várias opções de modelos subjacentes: O endpoint de imagem para vídeo da API da Runway oferece suporte a vários modelos de vídeo de backend, dando aos desenvolvedores flexibilidade quanto a qualidade, velocidade e custo.
- Autenticação de API em estilo de produção: Usa autenticação padrão com token Bearer e cabeçalhos explícitos de versão da API para integrações controladas.
- Suporte a saídas em retrato e paisagem: A Runway documenta tamanhos de saída para modos de geração horizontal e vertical nas famílias de modelos compatíveis.
- Compatibilidade com fluxo de trabalho de imagem de referência: A API é projetada em torno de imagens de referência, e a Runway fornece recomendações de tamanho de entrada para ajudar a manter a qualidade da geração.
- Adequação a pipeline criativo extensível: A plataforma mais ampla da Runway inclui fluxos de trabalho relacionados à geração de vídeo, como quadros-chave, expansão e outros modos de geração, tornando imagem para vídeo útil como uma etapa em um pipeline criativo maior.
Como acessar e integrar runwayml-image-to-video
Etapa 1: Cadastre-se para obter uma chave de API
Para começar, cadastre-se na CometAPI e gere sua chave de API no painel. Depois de obter a chave, armazene-a com segurança e use-a no cabeçalho Authorization em todas as solicitações.
Etapa 2: Envie solicitações para a API runwayml-image-to-video
Use o formato oficial da API da Runway via CometAPI. O endpoint é POST /runwayml/v1/image_to_video. Inclua o cabeçalho X-Runway-Version.
curl https://api.cometapi.com/runwayml/v1/image_to_video \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $COMETAPI_API_KEY" \
-H "X-Runway-Version: 2024-11-06" \
-d '{
"model": "gen4_aleph",
"promptText": "Your prompt here."
}'
Etapa 3: Recuperar e verificar resultados
A API retorna um objeto de tarefa com um ID de tarefa. Faça polling em GET /runwayml/v1/tasks/{task_id} para verificar o status da geração e, em seguida, recupere a URL de saída na resposta da tarefa concluída.