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

LTX-2 19B Video-to-Video LoRA: transformação precisa de movimento e estilo | RunComfy

ltx/ltx-2-19b/video-to-video/lora

Transforme vídeos existentes em sequências cinematográficas com movimento preciso, áudio sincronizado e estilos flexíveis usando um modelo LoRA de 19B.

Í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 ltx/ltx-2-19b/video-to-video/lora. Para entradas e saídas aceitas, consulte o esquema.

curl --request POST \
  --url https://model-api.runcomfy.net/v1/models/ltx/ltx-2-19b/video-to-video/lora \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "black-and-white video, a girl is playing a guitar, film grain",
    "video_url": "https://playgrounds-storage-public.runcomfy.net/tools/7312/media-files/input-1-1.mp4",
    "loras": [
      {
        "path": "Lightricks/LTX-2-19b-IC-LoRA-Detailer",
        "scale": 1
      }
    ]
  }'

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/ltx/ltx-2-19b/video-to-video/lora \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer <token>" \
  --data '{
    "prompt": "black-and-white video, a girl is playing a guitar, film grain",
    "video_url": "https://playgrounds-storage-public.runcomfy.net/tools/7312/media-files/input-1-1.mp4",
    "loras": [
      {
        "path": "Lightricks/LTX-2-19b-IC-LoRA-Detailer",
        "scale": 1
      }
    ]
  }'

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": [
    "prompt",
    "video_url",
    "loras"
  ],
  "properties": {
    "prompt": {
      "title": "Prompt",
      "description": "",
      "type": "string",
      "default": "black-and-white video, a girl is playing a guitar, film grain"
    },
    "video_url": {
      "title": "URL do vídeo",
      "description": "O URL do vídeo a partir do qual gerar o vídeo.",
      "type": "string",
      "default": "https://playgrounds-storage-public.runcomfy.net/tools/7312/media-files/input-1-1.mp4"
    },
    "image_url": {
      "title": "Imagem",
      "description": "Um URL opcional de uma imagem para usar como primeiro quadro do vídeo.",
      "type": "string"
    },
    "loras": {
      "title": "LoRAs",
      "description": "Lista de LoRAs a aplicar (máximo de 10).",
      "type": "array",
      "default": [
        {
          "path": "Lightricks/LTX-2-19b-IC-LoRA-Detailer",
          "scale": 1
        }
      ],
      "items": {
        "path": {
          "title": "Caminho do LoRA",
          "description": "URL ou ID do repositório Hugging Face (owner/repo) dos pesos LoRA.",
          "type": "string",
          "format": "str",
          "default": ""
        },
        "scale": {
          "title": "Escala do LoRA",
          "description": "Intensidade de aplicação do modelo LoRA.",
          "type": "float",
          "format": "float_slider_with_range",
          "minimum": 0,
          "maximum": 4,
          "default": 1
        }
      },
      "maxItems": 10,
      "minItems": 0
    },
    "match_video_length": {
      "title": "Ajustar à duração do vídeo",
      "description": "Quando ativado, o número de quadros é calculado pela duração e pelo FPS do vídeo. Quando desativado, usa num_frames.",
      "type": "boolean",
      "default": true
    },
    "num_frames": {
      "title": "Número de quadros",
      "description": "O número de quadros a serem gerados.",
      "type": "integer",
      "minimum": 9,
      "maximum": 481,
      "default": 121
    },
    "video_size": {
      "title": "Tamanho do vídeo",
      "description": "O tamanho do vídeo gerado.",
      "type": "string",
      "enum": [
        "auto",
        "square_hd",
        "square",
        "portrait_4_3",
        "portrait_16_9",
        "landscape_4_3",
        "landscape_16_9"
      ],
      "default": "auto"
    },
    "generate_audio": {
      "title": "Gerar áudio",
      "description": "Se deve gerar áudio para o vídeo.",
      "type": "boolean",
      "default": true
    },
    "use_multiscale": {
      "title": "Usar geração multiescala",
      "description": "Quando ativado, o modelo gera primeiro uma versão menor e depois refina os detalhes no tamanho final.",
      "type": "boolean",
      "default": true
    },
    "match_input_fps": {
      "title": "Igualar FPS de entrada",
      "description": "Quando true, o FPS de saída corresponde ao FPS do vídeo de entrada em vez de usar o FPS-alvo padrão.",
      "type": "boolean",
      "default": true
    },
    "fps": {
      "title": "Quadros por segundo",
      "description": "Os quadros por segundo do vídeo gerado.",
      "type": "float",
      "minimum": 1,
      "maximum": 60,
      "default": 25
    },
    "guidance_scale": {
      "title": "Escala de orientação",
      "description": "Intensidade com que o prompt orienta a geração.",
      "type": "float",
      "minimum": 1,
      "maximum": 10,
      "default": 3
    },
    "num_inference_steps": {
      "title": "Etapas de inferência",
      "description": "O número de etapas de inferência a serem usadas.",
      "type": "integer",
      "minimum": 8,
      "maximum": 50,
      "default": 40
    },
    "camera_lora": {
      "title": "LoRA de câmera",
      "description": "A câmera LoRA a ser usada para controlar o movimento da câmera.",
      "type": "string",
      "enum": [
        "dolly_in",
        "dolly_out",
        "dolly_left",
        "dolly_right",
        "jib_up",
        "jib_down",
        "static",
        "none"
      ],
      "default": "none"
    },
    "camera_lora_scale": {
      "title": "Escala do LoRA de câmera",
      "description": "Intensidade do LoRA de câmera para controlar o movimento.",
      "type": "float",
      "minimum": 0,
      "maximum": 1,
      "default": 1
    },
    "negative_prompt": {
      "title": "Prompt negativo",
      "description": "Descreve os elementos ou defeitos que devem ser evitados no resultado.",
      "type": "string",
      "default": "blurry, out of focus, overexposed, underexposed, low contrast, washed out colors, excessive noise, grainy texture, poor lighting, flickering, motion blur, distorted proportions, unnatural skin tones, deformed facial features, asymmetrical face, missing facial features, extra limbs, disfigured hands, wrong hand count, artifacts around text, inconsistent perspective, camera shake, incorrect depth of field, background too sharp, background clutter, distracting reflections, harsh shadows, inconsistent lighting direction, color banding, cartoonish rendering, 3D CGI look, unrealistic materials, uncanny valley effect, incorrect ethnicity, wrong gender, exaggerated expressions, wrong gaze direction, mismatched lip sync, silent or muted audio, distorted voice, robotic voice, echo, background noise, off-sync audio,incorrect dialogue, added dialogue, repetitive speech, jittery movement, awkward pauses, incorrect timing, unnatural transitions, inconsistent framing, tilted camera, flat lighting, inconsistent tone, cinematic oversaturation, stylized filters, or AI artifacts."
    },
    "seed": {
      "title": "Seed",
      "description": "",
      "type": "integer",
      "default": 0
    },
    "enable_prompt_expansion": {
      "title": "Ativar expansão do prompt",
      "description": "Define se o prompt deve ser expandido automaticamente.",
      "type": "boolean",
      "default": false
    },
    "video_output_type": {
      "title": "Formato de saída de vídeo",
      "description": "O tipo de saída do vídeo gerado.",
      "type": "string",
      "enum": [
        "X264 (.mp4)",
        "VP9 (.webm)",
        "PRORES4444 (.mov)",
        "GIF (.gif)"
      ],
      "default": "X264 (.mp4)"
    },
    "video_quality": {
      "title": "Qualidade do vídeo",
      "description": "A qualidade do vídeo gerado.",
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high",
        "maximum"
      ],
      "default": "high"
    },
    "preprocessor": {
      "title": "Pré-processador",
      "description": "Pré-processador aplicado ao vídeo de entrada.",
      "type": "string",
      "enum": [
        "depth",
        "canny",
        "pose",
        "none"
      ],
      "default": "none"
    },
    "ic_lora": {
      "title": "IC-LoRA",
      "description": "O tipo de IC-LoRA a ser carregado.",
      "type": "string",
      "enum": [
        "match_preprocessor",
        "canny",
        "depth",
        "pose",
        "detailer",
        "none"
      ],
      "default": "match_preprocessor"
    },
    "ic_lora_scale": {
      "title": "Escala do IC-LoRA",
      "description": "A escala do IC-LoRA a ser usada.",
      "type": "float",
      "minimum": 0,
      "maximum": 1,
      "default": 1
    },
    "video_strength": {
      "title": "Intensidade do vídeo",
      "description": "Intensidade do condicionamento por vídeo. Valores menores dão ao modelo mais liberdade para alterar o conteúdo.",
      "type": "float",
      "minimum": 0,
      "maximum": 1,
      "default": 1
    }
  }
}

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
  • MiniMax H3 Max
  • MiniMax H3 Max Reference to video
  • MiniMax H3 Max text to video
  • MiniMax H3 Open Reference To Video
  • Wan 3.0 Prime
  • Wan 2.7 Image to Video
  • Ver todos os modelos →
Modelos de Imagem
  • Wan 2.6 Image to Image
  • Flux 2 Flash Edit
  • Nano Banana Pro
  • GPT Image 2 Image Edit
  • Qwen Image 3.0 Edit
  • Qwen Image 3.0 Pro 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.