Passer au contenu

Ltx 2.3 Quality · Reference Video to Video

Intégrer

Identifiant du modèle 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"

Fichiers comme dans l’exemple: 0,27 $ 270 crédits API · ≈ 28,97 ₽ 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

Créez 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 pendant 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 au fur et à mesure de vos modifications.

•requis

Invite utilisée pour diriger 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 aussi la durée stable : les petites tailles permettent 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 rapport hauteur/largeur de la source dans les limites de LTX.

par défaut 121

Nombre d'images de sortie, soumis à un budget de stabilité IC-LoRA fondé 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 pour des dimensions de classe 720p, et davantage pour les petites tailles.

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...

Invite négative indiquant 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 utilisée comme image clé de la première image.

Déposez un fichier ou

Apparence d'ancrage d'image facultative vers le milieu du clip, complémentaire à l'image clé initiale `image_url`. Elle aide l'apparence à suivre le mouvement de la caméra plutôt qu'à dériver; `image_url` est requis.

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; `image_url` est requis.

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 force de conditionnement : les réglages plus faibles permettent davantage de changements.

par défaut 1

Contrôle du débruitage pour l'échantillonnage vidéo-à-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 calendrier de débruitage; lorsqu'il est activé, il contrôle la transformation des pixels sources : 1.0 régénère tout et les réglages plus faibles en préservent davantage, par exemple 0.5 en préserve environ 50 %.

par défaut 24

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

par défaut 15

Définissez le nombre de pas d’inférence à exécuter, jusqu’à 30; si vous ne le modifiez pas, 15 pas sont utilisés.

par défaut 1

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

Graine qui rend la génération reproductible. La définir sur None sélectionne une graine aléatoirement.

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

Exécuter cette requête

Votre clé reste dans ce navigateur : elle est envoyée uniquement au 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

Crée une nouvelle vidéo à partir d’un `prompt` obligatoire et d’un `video_url` de référence qui fournit le mouvement et la structure. Les `image_url`, `mid_image_url` et `end_image_url` facultatifs ancrent l’apparence au début, au milieu et à la fin. `video_strength` et `strength` (both 0 to 1) contrôlent la fidélité à la source ou sa préservation, et `control_video_url` peut fournir un signal de contrôle précalculé. `resolution` propose des préréglages automatiques ou fixes comme le carré et le portrait ou paysage 16:9.

Paramètres

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

NomType Par défautAutorisé Description
promptrequis
Typestring
Invite utilisée pour diriger 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 la sortie respecte 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 rapport hauteur/largeur 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; l'activer démarre la génération à partir de `video_url` tout en conservant le guidage structurel de `control_video_url`. Le débruitage via `strength` définit la quantité conservée; les réglages plus faibles conservent davantage de pixels originaux.
image_urlfacultatif image
Typeurl · image
Style d'ancrage d'image facultatif ou identité du personnage utilisée comme image clé de la première image.
mid_image_urlfacultatif
Typeurl · image
Apparence d'ancrage d'image facultative vers le milieu du clip, complémentaire à l'image clé initiale `image_url`. Elle aide l'apparence à suivre le mouvement de la caméra plutôt qu'à dériver; `image_url` est requis.
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; `image_url` est requis.
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 force de conditionnement : les réglages plus faibles permettent davantage de changements.
strengthfacultatif
Typenumber
Par défaut1
0 – 1
Contrôle du débruitage pour l'échantillonnage vidéo-à-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 calendrier de débruitage; lorsqu'il est activé, il contrôle la transformation des pixels sources : 1.0 régénère tout et les réglages plus faibles en préservent davantage, par exemple 0.5 en préserve environ 50 %.
num_framesfacultatif
Typeinteger
Par défaut121
9 – 481
Nombre d'images de sortie, soumis à un budget de stabilité IC-LoRA fondé 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 pour des dimensions de classe 720p, et davantage pour les petites tailles.
resolutionfacultatif
Typeobject
Par défautauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensions de la vidéo de sortie, qui influencent aussi la durée stable : les petites tailles permettent 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 rapport hauteur/largeur de la source dans les limites de LTX.
frames_per_secondfacultatif
Typenumber
Par défaut24
1 – 60
Fréquence d’images de la vidéo de sortie, mesurée en images par seconde.
num_inference_stepsfacultatif
Typeinteger
Par défaut15
8 – 30
Définissez le nombre de pas d’inférence à exécuter, jusqu’à 30; si vous ne le modifiez pas, 15 pas sont utilisés.
guidance_scalefacultatif
Typenumber
Par défaut1
1 – 20
Ajustez le guidage sans classificateur à l’aide de cette échelle; son réglage par défaut vise à la fois une qualité élevée et une génération rapide.
generate_audiofacultatif
Typeboolean
Par défauttrue
Interrupteur de la piste audio du MP4 retourné : désactivé, il produit un fichier vidéo seulement; 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
Invite négative indiquant ce que la génération doit éviter.
seedfacultatif
Typeinteger | null
Graine qui rend la génération reproductible. La définir sur None sélectionne une graine aléatoirement.
enable_prompt_expansionfacultatif
Typeboolean
Par défauttrue
Contrôle l’activation de l’expansion de l’invite.
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.
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",
  "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"
  }
}
Vos fichiers, votre choixChaque outputs[].url est une copie dans notre stockage : conservée indéfiniment (facturation par Go-mois) ou pendant 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, les vidéos et les fichiers audio. output est l’objet de résultat propre au modèle.
Champs de sortie
video
object {url, content_type, file_name, file_size}Vidéo produite par le modèle.
seed
integerValeur de départ réellement appliquée pendant la génération.
prompt
stringInvite 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 en Markdown se trouve à https://doitong.com/fr-CA/developers/models/ltx-2.3-quality/reference-video-to-video.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt