logo
RunComfy
  • ComfyUI
  • TreinadorNovo
  • Modelos
  • API
  • Preços
discord logo
MODELOS
Explorar
Todos os modelos
BIBLIOTECA
Gerações
APIS DE MODELOS
Documentação da API
Chaves API
CONTA
Uso

Runway Aleph 2: Edição de vídeo para vídeo in-context em Models and API | RunComfy

runwayml/runway-aleph-2/video-to-video

O Runway Aleph 2 aplica uma edição de texto a um clipe de 2–30 segundos mantendo movimento e enquadramento, com keyframes opcionais com carimbo de tempo.

Índice

1. Introdução2. Autenticação3. Referência da APIEnviar uma solicitaçãoStatus da solicitaçãoObter resultadosCancelar solicitação4. Arquivos de entradaArquivo hospedado (URL)5. EsquemaEsquema de entradaEsquema de saída

1. Introdução

Use a API RunComfy para executar runwayml/runway-aleph-2/video-to-video. Para entradas e saídas aceitas, consulte o esquema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/runwayml/runway-aleph-2/video-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "video_url": "https://playgrounds-storage-public.runcomfy.net/tools/7460/media-files/input.mp4",
    "prompt": "Restyle as 2D anime with clean cel-shaded linework and warm evening colors; keep the musician, saxophone, and camera framing."
  }'

2. Autenticação

Defina a variável de ambiente YOUR_API_TOKEN com sua chave de API (gerenciamento no Perfil) e inclua em cada solicitação um token Bearer no cabeçalho Authorization : Authorization: Bearer $YOUR_API_TOKEN.

3. Referência da API

Enviar uma solicitação

Envie um trabalho de geração assíncrono e receba imediatamente um request_id e URLs para status, resultados e cancelamento.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/runwayml/runway-aleph-2/video-to-video \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "video_url": "https://playgrounds-storage-public.runcomfy.net/tools/7460/media-files/input.mp4",
    "prompt": "Restyle as 2D anime with clean cel-shaded linework and warm evening colors; keep the musician, saxophone, and camera framing."
  }'

Status da solicitação

Obtém o estado atual de um request_id ("in_queue", "in_progress", "completed" ou "cancelled").

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
  --header "Authorization: Bearer <token>"

Obter resultados

Obtém as saídas finais e metadados do request_id; se o trabalho não estiver concluído, a resposta retorna o estado atual para continuar o polling.

curl --request GET \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
  --header "Authorization: Bearer <token>"

Cancelar solicitação

Cancela um trabalho na fila por request_id; trabalhos em andamento não podem ser cancelados.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
  --header "Authorization: Bearer <token>"

4. Arquivos de entrada

Arquivo hospedado (URL)

Forneça uma URL HTTPS publicamente acessível. O host deve permitir buscas no servidor (sem login/cookies), sem limite de taxa agressivo ou bloqueio de bots. Recomendado: imagens ≤ 50 MB (~4K), vídeos ≤ 100 MB (~2–5 min em 720p). Para ativos privados, URLs estáveis ou pré-assinadas.

5. Esquema

Esquema de entrada

{
  "type": "object",
  "title": "Esquema de entrada",
  "required": [
    "video_url",
    "prompt"
  ],
  "properties": {
    "video_url": {
      "title": "URL de vídeo",
      "description": "Vídeo de origem a editar. Deve ter 2–30 segundos e menos de 16 MB. A duração da saída segue este clipe.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7460/media-files/input.mp4",
      "validations": [
        {
          "validation_rule": "file_size_mb<",
          "validation_value": 16,
          "validation_error": "O tamanho do arquivo deve ser menor que 16 MB."
        }
      ]
    },
    "prompt": {
      "title": "Prompt",
      "description": "Instrução em linguagem natural que descreve a edição. Mantenha abaixo de 1000 caracteres.",
      "type": "string",
      "default": "Restyle as 2D anime with clean cel-shaded linework and warm evening colors; keep the musician, saxophone, and camera framing."
    },
    "keyframes": {
      "title": "Keyframes",
      "description": "Imagens de orientação opcionais, até 5. Cada item precisa de um URL de imagem e de um carimbo de tempo em segundos a partir do início do clipe de origem.",
      "type": "array",
      "maxItems": 5,
      "minItems": 0,
      "items": {
        "image_url": {
          "title": "URL de imagem",
          "description": "Imagem de orientação para este carimbo de tempo (URL HTTPS).",
          "type": "string",
          "format": "image_uri",
          "default": ""
        },
        "seconds": {
          "title": "Carimbo de tempo (s)",
          "description": "Carimbo de tempo absoluto em segundos a partir do início do vídeo de origem (0–30).",
          "type": "number",
          "format": "float_slider_with_range",
          "minimum": 0,
          "maximum": 30,
          "default": 0
        }
      }
    },
    "target_aspect_ratio": {
      "title": "Proporção de destino",
      "description": "Proporção opcional de expand/outpaint. Deixe sem definir para manter o quadro de origem.",
      "type": "string",
      "enum": [
        "16:9",
        "4:3",
        "3:2",
        "1:1",
        "2:3",
        "3:4",
        "9:16",
        "21:9"
      ]
    },
    "seed": {
      "title": "Seed",
      "description": "Seed opcional para tentativas mais repetíveis. Deixe sem definir para um sorteio aleatório.",
      "type": "integer",
      "minimum": 0,
      "maximum": 4294967295
    }
  }
}

Esquema de saída

{
  "output": {
    "type": "object",
    "properties": {
      "image": {
        "type": "string",
        "format": "uri",
        "description": "URL de imagem única"
      },
      "video": {
        "type": "string",
        "format": "uri",
        "description": "URL de vídeo único"
      },
      "images": {
        "type": "array",
        "description": "várias URLs de imagem",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "videos": {
        "type": "array",
        "description": "várias URLs de vídeo",
        "items": {
          "type": "string",
          "format": "uri"
        }
      }
    }
  }
}
Siga-nos
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
Suporte
  • Discord
  • E-mail
  • Status do Sistema
  • afiliado
Modelos de Vídeo
  • Wan 2.6 Flash
  • Wan 3.0
  • MiniMax H3 Max
  • Wan 3.0 Prime
  • Wan 2.7 Image to Video
  • MiniMax H3 Max Reference to video
  • Ver todos os modelos →
Modelos de Imagem
  • GPT Image 2.5 Flare
  • GPT Image 2.5 Sunburst
  • Seedream 4.5
  • Nano Banana Pro
  • Seedream 5.0 Pro
  • Nano Banana 2 Edit
  • Ver todos os modelos →
Legal
  • Termos de Serviço
  • Política de Privacidade
  • Política de Cookies
RunComfy
Copyright 2026 RunComfy. Todos os Direitos Reservados.

RunComfy é a principal ComfyUI plataforma, oferecendo ComfyUI online ambiente e serviços, juntamente com fluxos de trabalho do ComfyUI apresentando visuais impressionantes. RunComfy também oferece AI Models, permitindo que artistas utilizem as mais recentes ferramentas de AI para criar arte incrível.