Vai al contenuto

Ltx 2.3 Quality · Reference Video to Video

Integra

ID del modello 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"

File come nell'esempio: 0,27 $ 270 crediti API · ≈ 29,05 ₽ i tuoi file vengono misurati prima dell'esecuzione Esegui in questa pagina

Ottieni la chiave API
Lightricks · Video

Il tuo primo risultato apparirà qui

Crea una richiesta qui sotto ed eseguila con la tua chiave API. Gli output vengono copiati nella nostra archiviazione, conservati per sempre oppure 7 giorni gratuitamente.

Crea una richiesta

I controlli vengono generati dallo schema del modello. Il codice e il prezzo si aggiornano mentre li modifichi.

•obbligatorio

Prompt usato per dirigere la generazione.

•obbligatorio video_url
Trascina un file oppure

URL che punta a un video di riferimento usato per guidare movimento e struttura.

resolution predefinito auto

Dimensioni del video di output, che influiscono anche sulla durata stabile: dimensioni inferiori consentono più fotogrammi, mentre quelle maggiori riducono il massimo. La stima del controllo integrata mantiene le dimensioni vicine al flusso di lavoro ufficiale del controllo; il controllo diretto tramite `skip_control_preprocess` e `control_video_url` rispetta invece le dimensioni esplicite con allineamento a 64px. In modalità di controllo diretto, `auto` eredita le dimensioni e il rapporto d'aspetto del sorgente entro i limiti di LTX.

predefinito 121

Numero di fotogrammi dell'output, soggetto a un budget di stabilità IC-LoRA basato sulla risoluzione moltiplicata per i fotogrammi. Una risposta 422 indica che il budget è stato superato: riduci la risoluzione o `num_frames`. Il budget consente circa 150 fotogrammi con dimensioni di classe 720p e un numero maggiore a dimensioni inferiori.

Avanzate 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
predefinito color distortion, ove...

Prompt negativo che specifica cosa la generazione deve evitare.

Trascina un file oppure

Video di controllo precalcolato opzionale, usato al posto della stima del controllo integrata quando viene fornito insieme a `skip_control_preprocess`. Diventa il segnale di controllo diretto dopo il ricampionamento per adattarsi alle dimensioni dell'output e al numero di fotogrammi. Il video può, ad esempio, contenere già un composito renderizzato di profondità, bordi o posa.

image_url
Trascina un file oppure

Stile di ancoraggio dell'immagine o identità del personaggio opzionale come keyframe del primo fotogramma.

Trascina un file oppure

Aspetto opzionale per l'ancoraggio dell'immagine vicino al punto centrale della clip, a integrazione del keyframe iniziale `image_url`. Aiuta l'aspetto a seguire il movimento della fotocamera invece di deragliare; richiede `image_url`.

end_image_url
Trascina un file oppure

Aspetto opzionale per l'ancoraggio dell'immagine nell'ultimo fotogramma della clip. Utile quando il movimento della fotocamera termina in una posizione diversa da quella dell'immagine iniziale; richiede `image_url`.

video_quality predefinito high

Preset di qualità applicato al video di output.

video_write_mode predefinito balanced

Modalità di scrittura del video risultante.

predefinito 0.6

La libertà di modificare movimento e struttura del video di riferimento è controllata da questa intensità di condizionamento: valori più bassi consentono modifiche maggiori.

predefinito 1

Controllo del denoising per il campionamento video-da-video con video di riferimento, il cui effetto dipende da `preserve_original_video`. Quando la modalità è disattivata, accorcia semplicemente la pianificazione del denoising; quando è attiva, controlla la trasformazione dei pixel sorgente: 1.0 rigenera tutto, mentre valori più bassi ne preservano una quantità maggiore, ad esempio 0.5 ne conserva circa il 50%.

predefinito 24

Fotogramma rate del video di output, misurato in fotogrammi al secondo.

predefinito 15

Imposta quanti passaggi di inferenza eseguire, fino a 30; se lasciato invariato, usa 15.

predefinito 1

Regola la guidance classifier-free usando questa scala; la sua regolazione predefinita mira a un'elevata qualità e a una generazione rapida.

Seed che rende riproducibile la generazione. Impostarlo su None seleziona casualmente un seed.

POST /run/ltx-2.3-quality/reference-video-to-video?wait=20 preventivo → 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"

Esegui questa richiesta

La tua chiave rimane in questo browser: viene inviata solo al Doitong API e salvata in localStorage solo se selezioni Ricorda. Ottieni una chiave API

Informazioni su Ltx 2.3 Quality · Reference Video to Video

Crea un nuovo video da un `prompt` obbligatorio e da un `video_url` di riferimento che fornisce movimento e struttura. `image_url`, `mid_image_url` e `end_image_url` facoltativi definiscono l'aspetto all'inizio, a metà e alla fine. `video_strength` e `strength` (both 0 to 1) controllano quanto segue o preserva la sorgente, mentre `control_video_url` può fornire un segnale di controllo precalcolato. `resolution` offre preset automatici o fissi come quadrato e 16:9 verticale o orizzontale.

Parametri

Invia il nome canonico oppure il nome nativo, non entrambi. Nomi canonici

NomeTipo PredefinitoConsentiti Descrizione
promptobbligatorio
Tipostring
Prompt usato per dirigere la generazione.
video_urlobbligatorio video
Tipourl · video
URL che punta a un video di riferimento usato per guidare movimento e struttura.
control_video_urlfacoltativo
Tipourl · video
Video di controllo precalcolato opzionale, usato al posto della stima del controllo integrata quando viene fornito insieme a `skip_control_preprocess`. Diventa il segnale di controllo diretto dopo il ricampionamento per adattarsi alle dimensioni dell'output e al numero di fotogrammi. Il video può, ad esempio, contenere già un composito renderizzato di profondità, bordi o posa.
skip_control_preprocessfacoltativo
Tipoboolean
Predefinitofalse
Modalità di controllo diretto che usa `control_video_url` invece di stimare internamente profondità, bordi o posa; senza quell'URL, questa impostazione viene ignorata. Il dimensionamento dell'output in questa modalità rispetta le dimensioni esplicite con allineamento a 64 per mantenere abbinati i video RGB e di controllo, mentre `auto` usa le dimensioni e il rapporto d'aspetto del sorgente entro i limiti di LTX.
preserve_original_videofacoltativo
Tipoboolean
Predefinitofalse
Modalità di conservazione del video originale, disponibile solo con `skip_control_preprocess`, `video_url` e `control_video_url`. Disabilitata per impostazione predefinita, lascia invariata l'elaborazione standard del controllo; abilitarla avvia la generazione da `video_url`, mantenendo la guida strutturale di `control_video_url`. Il denoising tramite `strength` determina la quantità conservata: valori più bassi mantengono più pixel originali.
image_urlfacoltativo image
Tipourl · image
Stile di ancoraggio dell'immagine o identità del personaggio opzionale come keyframe del primo fotogramma.
mid_image_urlfacoltativo
Tipourl · image
Aspetto opzionale per l'ancoraggio dell'immagine vicino al punto centrale della clip, a integrazione del keyframe iniziale `image_url`. Aiuta l'aspetto a seguire il movimento della fotocamera invece di deragliare; richiede `image_url`.
end_image_urlfacoltativo end_image
Tipourl · image
Aspetto opzionale per l'ancoraggio dell'immagine nell'ultimo fotogramma della clip. Utile quando il movimento della fotocamera termina in una posizione diversa da quella dell'immagine iniziale; richiede `image_url`.
video_strengthfacoltativo
Tiponumber
Predefinito0.6
0 – 1
La libertà di modificare movimento e struttura del video di riferimento è controllata da questa intensità di condizionamento: valori più bassi consentono modifiche maggiori.
strengthfacoltativo
Tiponumber
Predefinito1
0 – 1
Controllo del denoising per il campionamento video-da-video con video di riferimento, il cui effetto dipende da `preserve_original_video`. Quando la modalità è disattivata, accorcia semplicemente la pianificazione del denoising; quando è attiva, controlla la trasformazione dei pixel sorgente: 1.0 rigenera tutto, mentre valori più bassi ne preservano una quantità maggiore, ad esempio 0.5 ne conserva circa il 50%.
num_framesfacoltativo
Tipointeger
Predefinito121
9 – 481
Numero di fotogrammi dell'output, soggetto a un budget di stabilità IC-LoRA basato sulla risoluzione moltiplicata per i fotogrammi. Una risposta 422 indica che il budget è stato superato: riduci la risoluzione o `num_frames`. Il budget consente circa 150 fotogrammi con dimensioni di classe 720p e un numero maggiore a dimensioni inferiori.
resolutionfacoltativo
Tipoobject
Predefinitoauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensioni del video di output, che influiscono anche sulla durata stabile: dimensioni inferiori consentono più fotogrammi, mentre quelle maggiori riducono il massimo. La stima del controllo integrata mantiene le dimensioni vicine al flusso di lavoro ufficiale del controllo; il controllo diretto tramite `skip_control_preprocess` e `control_video_url` rispetta invece le dimensioni esplicite con allineamento a 64px. In modalità di controllo diretto, `auto` eredita le dimensioni e il rapporto d'aspetto del sorgente entro i limiti di LTX.
frames_per_secondfacoltativo
Tiponumber
Predefinito24
1 – 60
Fotogramma rate del video di output, misurato in fotogrammi al secondo.
num_inference_stepsfacoltativo
Tipointeger
Predefinito15
8 – 30
Imposta quanti passaggi di inferenza eseguire, fino a 30; se lasciato invariato, usa 15.
guidance_scalefacoltativo
Tiponumber
Predefinito1
1 – 20
Regola la guidance classifier-free usando questa scala; la sua regolazione predefinita mira a un'elevata qualità e a una generazione rapida.
generate_audiofacoltativo
Tipoboolean
Predefinitotrue
Interruttore della traccia audio per l'MP4 restituito: disattivato produce un file solo video, mentre attivato include l'audio.
negative_promptfacoltativo
Tipostring
Predefinitocolor 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 che specifica cosa la generazione deve evitare.
seedfacoltativo
Tipointeger | null
Seed che rende riproducibile la generazione. Impostarlo su None seleziona casualmente un seed.
enable_prompt_expansionfacoltativo
Tipoboolean
Predefinitotrue
Controlla se l'espansione del prompt è abilitata.
enable_safety_checkerfacoltativo
Tipoboolean
Predefinitotrue
Controlla se il controllo di sicurezza è abilitato.
video_qualityfacoltativo
Tipoenum
Predefinitohigh
lowmediumhighmaximum
Preset di qualità applicato al video di output.
video_write_modefacoltativo
Tipoenum
Predefinitobalanced
fastbalancedsmall
Modalità di scrittura del video risultante.
obbligatorio Nome canonico, accettato anche

I parametri file accettano un URL pubblico https://, un URI data: fino a 10 MB oppure il file_url di un caricamento. File

Output

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"
  }
}
I tuoi file, la tua sceltaOgni outputs[].url è una copia nella nostra archiviazione: conservata per sempre (a pagamento per GB-mese) oppure 7 giorni gratuitamente, in base all'impostazione dell'account o a ?storage=.
Stessa struttura per ogni modellotype, url, content_type, width, height e duration, per immagini, video e audio. output è l'oggetto risultato del modello.
Campi dell'output
video
object {url, content_type, file_name, file_size}Video prodotto dal modello.
seed
integerSeed effettivamente applicato durante la generazione.
prompt
stringPrompt di generazione, inclusa qualsiasi espansione applicata prima dell'uso.

Altri modelli: Da video a video

Per gli agenti AI: questa pagina in Markdown è disponibile all'indirizzo https://doitong.com/it/developers/models/ltx-2.3-quality/reference-video-to-video.md. Tutti i modelli e le guide: https://doitong.com/developers/llms.txt