Ir para o conteúdo

Ltx 2.3 Quality · Reference Video to Video

Integrar

ID do modelo ltx-2.3-quality/reference-video-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ltx-2.3-quality/reference-video-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Arquivos como o exemplo: $ 0,27 270 créditos de API · ≈ ₽ 28,97 seus arquivos são medidos antes da execução Executar nesta página

Obter chave de API
Lightricks · Vídeo

Seu primeiro resultado aparecerá aqui

Monte uma requisição abaixo e execute-a com sua chave de API. As saídas são copiadas para nosso armazenamento, mantidas para sempre ou por 7 dias gratuitamente.

Criar uma solicitação

Os controles são gerados a partir do esquema do modelo. O código e o preço são atualizados conforme você os altera.

•obrigatório

Prompt usado para direcionar a geração.

•obrigatório video_url
Solte um arquivo ou

URL que aponta para um vídeo de referência usado para orientar o movimento e a estrutura.

resolution padrão auto

Dimensões do vídeo de saída, que também afetam a duração estável: tamanhos menores permitem mais quadros, enquanto tamanhos maiores reduzem o máximo. A estimativa de controle integrada mantém o tamanho próximo ao fluxo de trabalho de controle oficial; o controle direto por meio de `skip_control_preprocess` e `control_video_url` respeita dimensões explícitas com alinhamento de 64px. No modo de controle direto, `auto` herda as dimensões e a proporção da origem dentro dos limites do LTX.

padrão 121

Quantidade de quadros da saída, sujeita a um limite de estabilidade do IC-LoRA baseado na resolução multiplicada pelos quadros. Uma resposta 422 indica que esse limite foi excedido: reduza a resolução ou `num_frames`. O limite permite aproximadamente 150 quadros em dimensões da classe 720p e mais em tamanhos menores.

Avançado negative_prompt · control_video_url · image · mid_image_url · end_image · video_quality · video_write_mode · video_strength · strength · frames_per_second · num_inference_steps · guidance_scale · seed · skip_control_preprocess · preserve_original_video · enable_prompt_expansion · enable_safety_checker
padrão color distortion, ove...

Prompt negativo que especifica o que a geração deve evitar.

Solte um arquivo ou

Vídeo de controle pré-computado opcional, usado em vez da estimativa de controle integrada quando fornecido junto com `skip_control_preprocess`. Ele se torna o sinal de controle direto após a reamostragem para corresponder às dimensões de saída e à quantidade de quadros. O vídeo pode, por exemplo, conter um composto de profundidade, bordas ou pose já renderizado.

image_url
Solte um arquivo ou

Estilo opcional de ancoragem da imagem ou identidade do personagem como quadro-chave do primeiro quadro.

Solte um arquivo ou

Aparência opcional de ancoragem da imagem próxima ao ponto médio do clipe, complementando o quadro-chave inicial `image_url`. Isso ajuda a aparência a acompanhar o movimento da câmera em vez de derivar; requer `image_url`.

end_image_url
Solte um arquivo ou

Aparência opcional de ancoragem da imagem no quadro final do clipe. Útil quando o movimento da câmera termina em um local diferente da imagem inicial; requer `image_url`.

video_quality padrão high

Predefinição de qualidade aplicada ao vídeo de saída.

video_write_mode padrão balanced

Modo de gravação do vídeo resultante.

padrão 0.6

A liberdade para alterar o movimento e a estrutura do vídeo de referência é controlada por esta intensidade de condicionamento: configurações menores permitem mudanças maiores.

padrão 1

Controle de redução de ruído para amostragem de vídeo para vídeo baseada em vídeo de referência, cujo efeito depende de `preserve_original_video`. Quando esse modo está desativado, ele apenas encurta o cronograma de redução de ruído; quando ativado, controla a transformação dos pixels de origem, com 1.0 regenerando tudo e configurações menores preservando mais (por exemplo, 0.5 preserva cerca de 50%).

padrão 24

Taxa de quadros do vídeo de saída, medida em quadros por segundo.

padrão 15

Defina quantas etapas de inferência executar, até 30; deixar inalterado usa 15.

padrão 1

Ajuste classifier-free guidance usando esta escala; seu ajuste padrão busca alta qualidade e geração rápida.

Seed que torna a geração reproduzível. Defini-lo como None seleciona uma seed aleatoriamente.

POST /run/ltx-2.3-quality/reference-video-to-video?wait=20 cotação → $ 0,27
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ltx-2.3-quality/reference-video-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar esta solicitação

Sua chave permanece neste navegador: ela é enviada somente à Doitong API e salva (localStorage) apenas se você marcar Lembrar. Obter uma chave de API

Sobre Ltx 2.3 Quality · Reference Video to Video

Cria um novo vídeo a partir de um `prompt` obrigatório e de um `video_url` de referência que fornece movimento e estrutura. `image_url`, `mid_image_url` e `end_image_url` opcionais fixam a aparência no início, no meio e no fim. `video_strength` e `strength` (ambos 0 to 1) controlam o quanto a saída segue ou preserva a fonte, e `control_video_url` pode fornecer um sinal de controle pré-computado. `resolution` oferece predefinições automáticas ou fixas, como quadrado e retrato ou paisagem em 16:9.

Parâmetros

Envie o nome canônico ou o nome nativo, não ambos. Nomes canônicos

NomeTipo PadrãoPermitido Descrição
promptobrigatório
Tipostring
Prompt usado para direcionar a geração.
video_urlobrigatório video
Tipourl · video
URL que aponta para um vídeo de referência usado para orientar o movimento e a estrutura.
control_video_urlopcional
Tipourl · video
Vídeo de controle pré-computado opcional, usado em vez da estimativa de controle integrada quando fornecido junto com `skip_control_preprocess`. Ele se torna o sinal de controle direto após a reamostragem para corresponder às dimensões de saída e à quantidade de quadros. O vídeo pode, por exemplo, conter um composto de profundidade, bordas ou pose já renderizado.
skip_control_preprocessopcional
Tipoboolean
Padrãofalse
Modo de controle direto usando `control_video_url` em vez de estimar profundidade, bordas ou pose internamente; sem essa URL, esta configuração é ignorada. O dimensionamento da saída nesse modo respeita dimensões explícitas com alinhamento de 64 para manter os vídeos RGB e de controle correspondentes, enquanto `auto` usa as dimensões e a proporção da origem dentro dos limites do LTX.
preserve_original_videoopcional
Tipoboolean
Padrãofalse
Modo de preservação do vídeo original, disponível somente com `skip_control_preprocess`, `video_url` e `control_video_url`. Desativado por padrão, ele mantém o processamento de controle padrão; ativá-lo inicia a geração a partir de `video_url`, preservando a orientação estrutural de `control_video_url`. A redução de ruído por meio de `strength` define a quantidade preservada, com configurações menores mantendo mais pixels originais.
image_urlopcional image
Tipourl · image
Estilo opcional de ancoragem da imagem ou identidade do personagem como quadro-chave do primeiro quadro.
mid_image_urlopcional
Tipourl · image
Aparência opcional de ancoragem da imagem próxima ao ponto médio do clipe, complementando o quadro-chave inicial `image_url`. Isso ajuda a aparência a acompanhar o movimento da câmera em vez de derivar; requer `image_url`.
end_image_urlopcional end_image
Tipourl · image
Aparência opcional de ancoragem da imagem no quadro final do clipe. Útil quando o movimento da câmera termina em um local diferente da imagem inicial; requer `image_url`.
video_strengthopcional
Tiponumber
Padrão0.6
0 – 1
A liberdade para alterar o movimento e a estrutura do vídeo de referência é controlada por esta intensidade de condicionamento: configurações menores permitem mudanças maiores.
strengthopcional
Tiponumber
Padrão1
0 – 1
Controle de redução de ruído para amostragem de vídeo para vídeo baseada em vídeo de referência, cujo efeito depende de `preserve_original_video`. Quando esse modo está desativado, ele apenas encurta o cronograma de redução de ruído; quando ativado, controla a transformação dos pixels de origem, com 1.0 regenerando tudo e configurações menores preservando mais (por exemplo, 0.5 preserva cerca de 50%).
num_framesopcional
Tipointeger
Padrão121
9 – 481
Quantidade de quadros da saída, sujeita a um limite de estabilidade do IC-LoRA baseado na resolução multiplicada pelos quadros. Uma resposta 422 indica que esse limite foi excedido: reduza a resolução ou `num_frames`. O limite permite aproximadamente 150 quadros em dimensões da classe 720p e mais em tamanhos menores.
resolutionopcional
Tipoobject
Padrãoauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensões do vídeo de saída, que também afetam a duração estável: tamanhos menores permitem mais quadros, enquanto tamanhos maiores reduzem o máximo. A estimativa de controle integrada mantém o tamanho próximo ao fluxo de trabalho de controle oficial; o controle direto por meio de `skip_control_preprocess` e `control_video_url` respeita dimensões explícitas com alinhamento de 64px. No modo de controle direto, `auto` herda as dimensões e a proporção da origem dentro dos limites do LTX.
frames_per_secondopcional
Tiponumber
Padrão24
1 – 60
Taxa de quadros do vídeo de saída, medida em quadros por segundo.
num_inference_stepsopcional
Tipointeger
Padrão15
8 – 30
Defina quantas etapas de inferência executar, até 30; deixar inalterado usa 15.
guidance_scaleopcional
Tiponumber
Padrão1
1 – 20
Ajuste classifier-free guidance usando esta escala; seu ajuste padrão busca alta qualidade e geração rápida.
generate_audioopcional
Tipoboolean
Padrãotrue
Alternância da faixa de áudio do MP4 retornado: desativada produz um arquivo somente com vídeo, e ativada inclui áudio.
negative_promptopcional
Tipostring
Padrãocolor distortion, overexposure, static, blurry details, subtitles, style, artwork, painting, frame, still, dim overall tone, worst quality, low quality, JPEG compression artifacts, ugly, mutilated, extra fingers, poorly drawn hands, poorly drawn face, deformed, disfigured, malformed limbs, fused fingers, motionless frame, cluttered background, three legs, crowded background, walking backwards
Prompt negativo que especifica o que a geração deve evitar.
seedopcional
Tipointeger | null
Seed que torna a geração reproduzível. Defini-lo como None seleciona uma seed aleatoriamente.
enable_prompt_expansionopcional
Tipoboolean
Padrãotrue
Controla se a expansão do prompt está ativada.
enable_safety_checkeropcional
Tipoboolean
Padrãotrue
Controla se a verificação de segurança está ativada.
video_qualityopcional
Tipoenum
Padrãohigh
lowmediumhighmaximum
Predefinição de qualidade aplicada ao vídeo de saída.
video_write_modeopcional
Tipoenum
Padrãobalanced
fastbalancedsmall
Modo de gravação do vídeo resultante.
obrigatório Nome canônico, também aceito

Os parâmetros de arquivo aceitam uma URL https:// pública, um URI data: de até 10 MB ou o file_url de um upload. Arquivos

Saída

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ltx-2.3-quality/reference-video-to-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 270,
    "usd": "0.27",
    "charged": 270,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "seed": 42,
    "prompt": "string"
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Seus arquivos, sua escolhaCada outputs[].url é uma cópia em nosso armazenamento: mantida para sempre (cobrada por GB-mês) ou por 7 dias gratuitamente, conforme a configuração da sua conta ou ?storage=.
Mesmo formato em todos os modelostype, url, content_type, width, height e duration, para imagens, vídeos e áudios. output é o próprio objeto de resultado do modelo.
Campos da saída
video
object {url, content_type, file_name, file_size}Vídeo produzido pelo modelo.
seed
integerSeed efetivamente aplicada durante a geração.
prompt
stringPrompt de geração, incluindo qualquer expansão aplicada antes do uso.

Mais modelos: Vídeo para vídeo

Para agentes de IA: esta página em Markdown está em https://doitong.com/pt-BR/developers/models/ltx-2.3-quality/reference-video-to-video.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt