Avançar 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"

Ficheiros como o exemplo: 0,27 $ 270 créditos da API · ≈ 29,05 ₽ os seus ficheiros são medidos antes da execução Executar nesta página

Obter chave de API
Lightricks · Vídeo

O seu primeiro resultado aparece aqui

Crie um pedido abaixo e execute-o com a sua chave de API. As saídas são copiadas para o nosso armazenamento, guardadas para sempre ou durante 7 dias gratuitamente.

Criar um pedido

Os controlos são gerados a partir do esquema do modelo. O código e o preço são atualizados à medida que os altera.

•obrigatório

Prompt utilizado para orientar a geração.

•obrigatório video_url
Largue um ficheiro ou

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

resolution predefinição auto

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

predefinição 121

Contagem de frames de saída, sujeita a um orçamento de estabilidade IC-LoRA baseado na resolução multiplicada pelos frames. Uma resposta 422 significa que esse orçamento foi excedido: reduza a resolução ou `num_frames`. O orçamento permite aproximadamente 150 frames 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
predefinição color distortion, ove...

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

Largue um ficheiro ou

Vídeo de controlo pré-calculado opcional, usado em vez da estimativa de controlo integrada quando fornecido juntamente com `skip_control_preprocess`. Torna-se o sinal de controlo direto depois de ser reamostrado para corresponder às dimensões de saída e à contagem de frames. O vídeo pode, por exemplo, conter uma composição de profundidade, contornos ou pose já renderizada.

image_url
Largue um ficheiro ou

Estilo de ancoragem de imagem ou identidade de personagem opcional como keyframe do primeiro frame.

Largue um ficheiro ou

Aspeto de ancoragem de imagem opcional próximo do ponto médio do clip, complementando o keyframe inicial `image_url`. Ajuda o aspeto a acompanhar o movimento da câmara em vez de se desviar; requer `image_url`.

end_image_url
Largue um ficheiro ou

Aspeto de ancoragem de imagem opcional no frame final do clip. Útil quando o movimento da câmara termina num local diferente da imagem inicial; requer `image_url`.

video_quality predefinição high

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

video_write_mode predefinição balanced

Modo de escrita do vídeo resultante.

predefinição 0.6

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

predefinição 1

Controlo de remoção de ruído para amostragem de vídeo-para-vídeo com vídeo de referência, cujo efeito depende de `preserve_original_video`. Quando esse modo está desativado, apenas encurta o ciclo de remoção de ruído; quando está ativado, controla a transformação dos pixels de origem, com 1.0 a regenerar tudo e valores inferiores a preservar mais (por exemplo, 0.5 preserva cerca de 50%).

predefinição 24

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

predefinição 15

Defina quantos passos de inferência executar, até 30; deixar este valor inalterado usa 15.

predefinição 1

Ajuste a classifier-free guidance usando esta escala; a afinação predefinida visa simultaneamente elevada qualidade e geração rápida.

Seed que torna a geração reproduzível. Defini-la 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 este pedido

A sua chave permanece neste navegador: é enviada apenas para a Doitong API e guardada em localStorage apenas se selecionar 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. Os `image_url`, `mid_image_url` e `end_image_url` opcionais fixam o aspeto no início, no meio e no fim. `video_strength` e `strength` (both 0 to 1) controlam o grau de seguimento ou preservação da origem, e `control_video_url` pode fornecer um sinal de controlo pré-calculado. `resolution` oferece predefinições automáticas ou fixas, como quadrado e retrato ou paisagem 16:9.

Parâmetros

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

NomeTipo PredefiniçãoPermitido Descrição
promptobrigatório
Tipostring
Prompt utilizado para orientar 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 controlo pré-calculado opcional, usado em vez da estimativa de controlo integrada quando fornecido juntamente com `skip_control_preprocess`. Torna-se o sinal de controlo direto depois de ser reamostrado para corresponder às dimensões de saída e à contagem de frames. O vídeo pode, por exemplo, conter uma composição de profundidade, contornos ou pose já renderizada.
skip_control_preprocessopcional
Tipoboolean
Predefiniçãofalse
Modo de controlo direto usando `control_video_url` em vez de estimar internamente a profundidade, os contornos ou a pose; sem esse URL, esta definição é ignorada. O dimensionamento da saída neste modo respeita dimensões explícitas com alinhamento a 64 para manter os vídeos RGB e de controlo correspondentes, enquanto `auto` usa as dimensões e a proporção da origem dentro dos limites do LTX.
preserve_original_videoopcional
Tipoboolean
Predefiniçãofalse
Modo de preservação do vídeo original, disponível apenas com `skip_control_preprocess`, `video_url` e `control_video_url`. Desativado por predefinição, mantém o processamento de controlo padrão; ao ativá-lo, inicia a geração a partir de `video_url`, mantendo a orientação estrutural de `control_video_url`. A remoção de ruído através de `strength` define a quantidade preservada, com valores inferiores a preservar mais pixels originais.
image_urlopcional image
Tipourl · image
Estilo de ancoragem de imagem ou identidade de personagem opcional como keyframe do primeiro frame.
mid_image_urlopcional
Tipourl · image
Aspeto de ancoragem de imagem opcional próximo do ponto médio do clip, complementando o keyframe inicial `image_url`. Ajuda o aspeto a acompanhar o movimento da câmara em vez de se desviar; requer `image_url`.
end_image_urlopcional end_image
Tipourl · image
Aspeto de ancoragem de imagem opcional no frame final do clip. Útil quando o movimento da câmara termina num local diferente da imagem inicial; requer `image_url`.
video_strengthopcional
Tiponumber
Predefiniçã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: valores menores permitem alterações maiores.
strengthopcional
Tiponumber
Predefinição1
0 – 1
Controlo de remoção de ruído para amostragem de vídeo-para-vídeo com vídeo de referência, cujo efeito depende de `preserve_original_video`. Quando esse modo está desativado, apenas encurta o ciclo de remoção de ruído; quando está ativado, controla a transformação dos pixels de origem, com 1.0 a regenerar tudo e valores inferiores a preservar mais (por exemplo, 0.5 preserva cerca de 50%).
num_framesopcional
Tipointeger
Predefinição121
9 – 481
Contagem de frames de saída, sujeita a um orçamento de estabilidade IC-LoRA baseado na resolução multiplicada pelos frames. Uma resposta 422 significa que esse orçamento foi excedido: reduza a resolução ou `num_frames`. O orçamento permite aproximadamente 150 frames em dimensões da classe 720p e mais em tamanhos menores.
resolutionopcional
Tipoobject
Predefiniçã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 frames, enquanto tamanhos maiores reduzem o máximo. A estimativa de controlo integrada mantém o tamanho próximo do fluxo de controlo oficial; o controlo direto através de `skip_control_preprocess` e `control_video_url` respeita dimensões explícitas com alinhamento de 64px. No modo de controlo direto, `auto` herda as dimensões e a proporção da origem dentro dos limites do LTX.
frames_per_secondopcional
Tiponumber
Predefinição24
1 – 60
Taxa de frames do vídeo de saída, medida em frames por segundo.
num_inference_stepsopcional
Tipointeger
Predefinição15
8 – 30
Defina quantos passos de inferência executar, até 30; deixar este valor inalterado usa 15.
guidance_scaleopcional
Tiponumber
Predefinição1
1 – 20
Ajuste a classifier-free guidance usando esta escala; a afinação predefinida visa simultaneamente elevada qualidade e geração rápida.
generate_audioopcional
Tipoboolean
Predefiniçãotrue
Ativação da faixa de áudio para o MP4 devolvido: desativada produz um ficheiro apenas de vídeo e ativada inclui áudio.
negative_promptopcional
Tipostring
Predefiniçã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-la como None seleciona uma seed aleatoriamente.
enable_prompt_expansionopcional
Tipoboolean
Predefiniçãotrue
Controla se a expansão do prompt está ativada.
enable_safety_checkeropcional
Tipoboolean
Predefiniçãotrue
Controla se a verificação de segurança está ativada.
video_qualityopcional
Tipoenum
Predefiniçãohigh
lowmediumhighmaximum
Predefinição de qualidade aplicada ao vídeo de saída.
video_write_modeopcional
Tipoenum
Predefiniçãobalanced
fastbalancedsmall
Modo de escrita do vídeo resultante.
obrigatório Nome canónico, também aceite

Os parâmetros de ficheiro aceitam um URL https:// público, um URI data: até 10 MB ou o file_url de um carregamento. Ficheiros

Resultado

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"
  }
}
Os seus ficheiros, a sua escolhaCada outputs[].url é uma cópia no nosso armazenamento: guardada para sempre (paga por GB-mês) ou durante 7 dias gratuitamente, conforme a definição da sua conta ou ?storage=.
A mesma estrutura em todos os modelostype, url, content_type, width, height e duration, tanto para imagens como para vídeo e áudio. output é o próprio objeto de resultado do modelo.
Campos do resultado
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 da utilização.

Mais modelos: Vídeo para vídeo

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