runway_video2video

Especificações técnicas de runway-video2video

O que é runway-video2video?

runway-video2video é o identificador de modelo da CometAPI para a capacidade de geração de vídeo para vídeo da Runway, um fluxo de trabalho que pega um clipe de vídeo existente e o re-renderiza em um novo estilo visual ou interpretação orientada por movimento usando orientação baseada em prompt. Na prática, isso é usado para estilização, transformação de cena, desenvolvimento de look, VFX experimentais e para transformar filmagens brutas em resultados mais cinematográficos ou imaginativos.

A documentação de ajuda da Runway descreve Video to Video como uma forma de alterar o estilo de vídeos usando um prompt de texto ou uma imagem de entrada como o primeiro frame. Suas orientações de produto mais recentes também indicam que, enquanto Gen-3 Alpha e Turbo suportavam esse fluxo de trabalho, recomendações mais novas da Runway apontam os usuários para ferramentas de nova geração para os casos de uso mais recentes de vídeo para vídeo. Do ponto de vista da integração com a CometAPI, porém, runway-video2video é o ID de modelo da plataforma usado para acessar essa classe de capacidade.

Principais recursos de runway-video2video

• Geração guiada por vídeo: Parte de um vídeo de entrada existente em vez de gerar movimento do zero, sendo útil para preservar a estrutura do plano, o tempo e a composição enquanto altera o resultado visual.
• Transformação baseada em prompt: Usa instruções em linguagem natural para controlar o estilo de saída, o clima, a reinterpretação do sujeito ou a direção de efeitos visuais.
• Transferência de estilo e re-renderização criativa: Bem adequado para converter filmagens em tratamentos animados, cinematográficos, surreais ou de marca, sem edição manual quadro a quadro. Esta é uma inferência com base no fluxo de trabalho de estilização vídeo para vídeo descrito pela Runway.
• Fluxos de trabalho com reconhecimento de referências: A documentação da Runway indica suporte a orientação informada por imagem em fluxos de geração de vídeo relacionados, o que ajuda a direcionar a composição ou a consistência estética.
• Opções de saída em retrato e paisagem: Os fluxos de trabalho compatíveis incluem formatos horizontal e vertical, o que é útil para entrega em social, dispositivos móveis e marketing.
• Eficiência em produções de formato curto: O fluxo referenciado suporta clipes de até 20 segundos, o que se adequa a peças publicitárias, planos conceituais, postagens em redes sociais e pipelines de iteração rápida.
• Acessibilidade via API: A Runway fornece documentação de API e padrões de acesso a modelos, permitindo integração programática em apps criativos, ferramentas internas e pipelines automatizados de mídia.

Como acessar e integrar runway-video2video

Etapa 1: Cadastre-se para obter a 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 para autenticar solicitações ao endpoint da CometAPI.

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

Use o formato oficial de API da Runway via CometAPI. O endpoint é POST /runwayml/v1/video_to_video. Você deve incluir o cabeçalho X-Runway-Version.

curl https://api.cometapi.com/runwayml/v1/video_to_video \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $COMETAPI_API_KEY" \
  -H "X-Runway-Version: 2024-11-06" \
  -d '{
    "model": "gen4_aleph",
    "videoUri": "https://example.com/your-source-video.mp4",
    "promptText": "Transform this footage into a cinematic neon-lit sci-fi sequence with dramatic atmosphere and smooth motion.",
    "seed": 1,
    "ratio": "1280:720",
    "references": [],
    "contentModeration": {
      "publicFigureThreshold": "auto"
    }
  }'

import os, requests

resp = requests.post(
    "https://api.cometapi.com/runwayml/v1/video_to_video",
    headers={
        "Authorization": f"Bearer {os.environ['COMETAPI_API_KEY']}",
        "Content-Type": "application/json",
        "X-Runway-Version": "2024-11-06",
    },
    json={
        "model": "gen4_aleph",
        "videoUri": "https://example.com/your-source-video.mp4",
        "promptText": "Transform this footage into a cinematic neon-lit sci-fi sequence.",
        "seed": 1,
        "ratio": "1280:720",
        "references": [],
        "contentModeration": {"publicFigureThreshold": "auto"},
    },
)
print(resp.json())

Etapa 3: Recupere e verifique os resultados

A API retorna um objeto de tarefa. Consulte o endpoint de status da tarefa para verificar quando a geração do vídeo for concluída e, em seguida, recupere a URL do vídeo de saída. Para uso em produção, adicione novas tentativas, polling de status e logs para garantir integração confiável com runway-video2video.