Passer au contenu

Ltx 2.3 Quality · Reference Video to Video · LoRA

Intégrer

Identifiant du modèle ltx-2.3-quality/reference-video-to-video/lora
# 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/lora?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",
    "loras": [
      {
        "path": "https://example.com/your-file.safetensors"
      }
    ]
  }'

# 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"

Fichiers comme dans l’exemple: 0,304 $ 304 crédits API · ≈ 32,70 ₽ vos fichiers sont mesurés avant l’exécution L’exécuter sur cette page

Obtenir une clé API
Lightricks · Vidéo

Votre premier résultat apparaîtra ici

Construisez une requête ci-dessous et exécutez-la avec votre clé API. Les sorties sont copiées dans notre stockage, conservées indéfiniment ou 7 jours gratuitement.

Créer une requête

Les contrôles sont générés à partir du schéma du modèle. Le code et le prix se mettent à jour lorsque vous les modifiez.

•requis

Prompt utilisé pour orienter la génération.

•requis video_url
Déposez un fichier, ou

URL pointant vers une vidéo de référence utilisée pour guider le mouvement et la structure.

resolution par défaut auto

Dimensions de la vidéo de sortie, qui influencent également la durée stable : les petites tailles autorisent davantage d’images, tandis que les grandes réduisent le maximum. L’estimation de contrôle intégrée conserve une taille proche du flux de contrôle officiel ; le contrôle direct via `skip_control_preprocess` et `control_video_url` respecte plutôt les dimensions explicites avec un alignement sur 64px. En mode de contrôle direct, `auto` reprend les dimensions et le ratio d’aspect de la source dans les limites de LTX.

par défaut 121

Nombre d’images de sortie, soumis à un budget de stabilité IC-LoRA basé sur la résolution multipliée par le nombre d’images. Une réponse 422 signifie que ce budget a été dépassé : réduisez la résolution ou `num_frames`. Le budget autorise environ 150 images aux dimensions de classe 720p, et davantage pour les tailles plus petites.

•requis

Ajouts LoRA pour LTX-2.3, chacun limité à 3 GB, avec au plus 3 entrées autorisées. Le chargement a lieu uniquement après que le téléchargeur du registre, sécurisé contre les SSRF, a récupéré chaque chemin.

Avancé 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
par défaut color distortion, ove...

Prompt négatif précisant ce que la génération doit éviter.

Déposez un fichier, ou

Vidéo de contrôle précalculée facultative, utilisée à la place de l’estimation de contrôle intégrée lorsqu’elle est fournie avec `skip_control_preprocess`. Elle devient le signal de contrôle direct après rééchantillonnage pour correspondre aux dimensions de sortie et au nombre d’images. La vidéo peut par exemple contenir un composite de profondeur, de contours ou de pose déjà rendu.

image_url
Déposez un fichier, ou

Style d’ancrage d’image facultatif ou identité du personnage pour l’image clé de la première image.

Déposez un fichier, ou

Apparence d’ancrage d’image facultative près du milieu du clip, complémentaire de l’image clé initiale `image_url`. Elle aide l’apparence à suivre le mouvement de la caméra plutôt qu’à dériver ; nécessite `image_url`.

end_image_url
Déposez un fichier, ou

Apparence d’ancrage d’image facultative à la dernière image du clip. Utile lorsque le mouvement de la caméra se termine à un endroit différent de l’image de départ ; nécessite `image_url`.

video_quality par défaut high

Préréglage de qualité appliqué à la vidéo de sortie.

video_write_mode par défaut balanced

Mode d’écriture de la vidéo résultante.

par défaut 0.6

La liberté de modifier le mouvement et la structure de la vidéo de référence est contrôlée par cette intensité de conditionnement : les valeurs plus faibles autorisent davantage de changements.

par défaut 1

Contrôle du débruitage pour l’échantillonnage vidéo-à-vidéo à partir d’une vidéo de référence, dont l’effet dépend de `preserve_original_video`. Lorsque ce mode est désactivé, il raccourcit simplement le programme de débruitage ; lorsqu’il est activé, il contrôle la transformation des pixels source, 1.0 régénérant tout et les valeurs plus faibles en préservant davantage (par exemple, 0.5 préserve environ 50 %).

par défaut 24

Fréquence d'images de sortie vidéo, mesurée en images par seconde.

par défaut 15

Définissez le nombre d'étapes d'inférence à exécuter, jusqu'à 30 ; sans modification, la valeur est 15.

par défaut 1

Ajustez le guidage sans classifieur à l'aide de cette échelle ; son réglage par défaut vise à la fois une haute qualité et une génération rapide.

Seed rendant la génération reproductible. La valeur None sélectionne un seed aléatoire.

POST /run/ltx-2.3-quality/reference-video-to-video/lora?wait=20 devis → 0,304 $
# 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/lora?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",
    "loras": [
      {
        "path": "https://example.com/your-file.safetensors"
      }
    ]
  }'

# 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"

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement à la Doitong API et enregistrée dans localStorage uniquement si vous cochez Mémoriser. Obtenir une clé API

À propos de Ltx 2.3 Quality · Reference Video to Video · LoRA

Génère une vidéo à partir d'un `prompt` obligatoire et d'un `video_url` de référence pour le mouvement et la structure, et requiert également `loras`, jusqu'à 3 fichiers LoRA de 3 GB maximum chacun. Les images clés facultatives de début, du milieu et de fin (`image_url`, `mid_image_url`, `end_image_url`) ancrent l'apparence. `video_strength` et `strength` vont de 0 à 1, et `num_frames` de 9 à 481.

Paramètres

Envoyez soit le nom canonique, soit le nom natif, mais pas les deux. Noms canoniques

NomType Par défautAutorisé Description
promptrequis
Typestring
Prompt utilisé pour orienter la génération.
video_urlrequis video
Typeurl · video
URL pointant vers une vidéo de référence utilisée pour guider le mouvement et la structure.
control_video_urlfacultatif
Typeurl · video
Vidéo de contrôle précalculée facultative, utilisée à la place de l’estimation de contrôle intégrée lorsqu’elle est fournie avec `skip_control_preprocess`. Elle devient le signal de contrôle direct après rééchantillonnage pour correspondre aux dimensions de sortie et au nombre d’images. La vidéo peut par exemple contenir un composite de profondeur, de contours ou de pose déjà rendu.
skip_control_preprocessfacultatif
Typeboolean
Par défautfalse
Mode de contrôle direct utilisant `control_video_url` au lieu d’estimer la profondeur, les contours ou la pose en interne ; sans cette URL, ce réglage est ignoré. Le dimensionnement de sortie respecte alors les dimensions explicites avec un alignement sur 64 pour garder les vidéos RGB et de contrôle correspondantes, tandis que `auto` reprend les dimensions et le ratio d’aspect de la source dans les limites de LTX.
preserve_original_videofacultatif
Typeboolean
Par défautfalse
Mode de conservation de la vidéo originale, disponible uniquement avec `skip_control_preprocess`, `video_url` et `control_video_url`. Désactivé par défaut, il conserve le traitement de contrôle standard ; son activation lance la génération depuis `video_url` tout en conservant le guidage structurel de `control_video_url`. Le débruitage via `strength` définit la quantité conservée, les valeurs plus faibles préservant davantage de pixels originaux.
image_urlfacultatif image
Typeurl · image
Style d’ancrage d’image facultatif ou identité du personnage pour l’image clé de la première image.
mid_image_urlfacultatif
Typeurl · image
Apparence d’ancrage d’image facultative près du milieu du clip, complémentaire de l’image clé initiale `image_url`. Elle aide l’apparence à suivre le mouvement de la caméra plutôt qu’à dériver ; nécessite `image_url`.
end_image_urlfacultatif end_image
Typeurl · image
Apparence d’ancrage d’image facultative à la dernière image du clip. Utile lorsque le mouvement de la caméra se termine à un endroit différent de l’image de départ ; nécessite `image_url`.
video_strengthfacultatif
Typenumber
Par défaut0.6
0 – 1
La liberté de modifier le mouvement et la structure de la vidéo de référence est contrôlée par cette intensité de conditionnement : les valeurs plus faibles autorisent davantage de changements.
strengthfacultatif
Typenumber
Par défaut1
0 – 1
Contrôle du débruitage pour l’échantillonnage vidéo-à-vidéo à partir d’une vidéo de référence, dont l’effet dépend de `preserve_original_video`. Lorsque ce mode est désactivé, il raccourcit simplement le programme de débruitage ; lorsqu’il est activé, il contrôle la transformation des pixels source, 1.0 régénérant tout et les valeurs plus faibles en préservant davantage (par exemple, 0.5 préserve environ 50 %).
num_framesfacultatif
Typeinteger
Par défaut121
9 – 481
Nombre d’images de sortie, soumis à un budget de stabilité IC-LoRA basé sur la résolution multipliée par le nombre d’images. Une réponse 422 signifie que ce budget a été dépassé : réduisez la résolution ou `num_frames`. Le budget autorise environ 150 images aux dimensions de classe 720p, et davantage pour les tailles plus petites.
resolutionfacultatif
Typeobject
Par défautauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensions de la vidéo de sortie, qui influencent également la durée stable : les petites tailles autorisent davantage d’images, tandis que les grandes réduisent le maximum. L’estimation de contrôle intégrée conserve une taille proche du flux de contrôle officiel ; le contrôle direct via `skip_control_preprocess` et `control_video_url` respecte plutôt les dimensions explicites avec un alignement sur 64px. En mode de contrôle direct, `auto` reprend les dimensions et le ratio d’aspect de la source dans les limites de LTX.
frames_per_secondfacultatif
Typenumber
Par défaut24
1 – 60
Fréquence d'images de sortie vidéo, mesurée en images par seconde.
num_inference_stepsfacultatif
Typeinteger
Par défaut15
8 – 30
Définissez le nombre d'étapes d'inférence à exécuter, jusqu'à 30 ; sans modification, la valeur est 15.
guidance_scalefacultatif
Typenumber
Par défaut1
1 – 20
Ajustez le guidage sans classifieur à l'aide de cette échelle ; son réglage par défaut vise à la fois une haute qualité et une génération rapide.
generate_audiofacultatif
Typeboolean
Par défauttrue
Paramètre de la piste audio du MP4 renvoyé : désactivé, il produit un fichier vidéo uniquement ; activé, il inclut l'audio.
negative_promptfacultatif
Typestring
Par défautcolor 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 négatif précisant ce que la génération doit éviter.
seedfacultatif
Typeinteger | null
Seed rendant la génération reproductible. La valeur None sélectionne un seed aléatoire.
enable_prompt_expansionfacultatif
Typeboolean
Par défauttrue
Contrôle l’activation de l’expansion du prompt.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Contrôle si la vérification de sécurité est activée.
video_qualityfacultatif
Typeenum
Par défauthigh
lowmediumhighmaximum
Préréglage de qualité appliqué à la vidéo de sortie.
video_write_modefacultatif
Typeenum
Par défautbalanced
fastbalancedsmall
Mode d’écriture de la vidéo résultante.
lorasrequis
Typeobject[]
≤ 3 éléments
Ajouts LoRA pour LTX-2.3, chacun limité à 3 GB, avec au plus 3 entrées autorisées. Le chargement a lieu uniquement après que le téléchargeur du registre, sécurisé contre les SSRF, a récupéré chaque chemin.
loras[].pathrequis
Typestring
≤ 2048 characters
URL HTTP(S) directe vers un fichier LoRA .safetensors de 3 GB maximum. Le chargement est précédé d'une récupération par un téléchargeur sécurisé contre les SSRF.
loras[].scalefacultatif
Typenumber
Par défaut1
0 – 2
L'influence de la LoRA sur la vidéo générée augmente avec cette intensité dans la plage 0.0–2.0.
loras[].transformerfacultatif
Typeenum
Par défautboth
highlowboth
Indicateur de sélection du Transformer : 'both' convient à presque tous les utilisateurs de LTX-2.3, car le modèle ne possède qu'un seul Transformer. Cet indicateur prend en charge les futures architectures comportant plusieurs Transformers.
requis Nom canonique, également accepté

Les paramètres de fichier acceptent une URL publique https://, un URI data: jusqu’à 10 MB ou le file_url d’un téléversement. Fichiers

Sortie

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ltx-2.3-quality/reference-video-to-video/lora",
  "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": 304,
    "usd": "0.304",
    "charged": 304,
    "refunded": 0
  },
  "input": {
    "loras": [
      {
        "path": "https://example.com/your-file.safetensors"
      }
    ],
    "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"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation au Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Même structure pour chaque modèletype, url, content_type, width, height et duration, pour les images, vidéos et fichiers audio. output est le propre objet de résultat du modèle.
Champs de sortie
video
object {url, content_type, file_name, file_size}Vidéo produite par le modèle.
seed
integerSeed effectivement appliqué pendant la génération.
prompt
stringPrompt de génération, y compris toute expansion appliquée avant son utilisation.

Plus de modèles : Vidéo vers vidéo

Pour les agents IA : cette page au format Markdown est disponible à https://doitong.com/fr/developers/models/ltx-2.3-quality/reference-video-to-video/lora.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt