Accéder 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 · ≈ 29,05 ₽ 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.

•obligatoire

Invite utilisée pour orienter la génération.

•obligatoire 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 rapport 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 pour des dimensions de classe 720p, et davantage pour des tailles inférieures.

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 une composition de profondeur, de contours ou de pose déjà rendue.

image_url
Déposez un fichier ou

Style d’ancrage d’image ou identité de personnage facultatif utilisé comme image clé de la première image.

Déposez un fichier ou

Apparence d’ancrage d’image facultative vers le milieu du clip, en complément 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 emplacement différent de celui 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 faibles autorisent 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 valeurs plus faibles en préservent davantage, par exemple 0.5 en conserve 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 ; laisser ce réglage inchangé utilise 15.

par défaut 1

Ajustez le classifier-free guidance avec 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 à 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

Crée une nouvelle vidéo à partir d'un `prompt` obligatoire et d'une `video_url` de référence qui fournit le mouvement et la structure. Les `image_url`, `mid_image_url` et `end_image_url` facultatifs définissent l'apparence au début, au milieu et à la fin. `video_strength` et `strength` (tous deux de 0 à 1) contrôlent le degré de fidélité ou de conservation de la source, et `control_video_url` peut fournir un signal de contrôle précalculé. `resolution` propose des préréglages automatiques ou fixes, notamment carré et 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
promptobligatoire
Typestring
Invite utilisée pour orienter la génération.
video_urlobligatoire 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 une composition de profondeur, de contours ou de pose déjà rendue.
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 paramètre est ignoré. Dans ce mode, les dimensions explicites sont respectées avec un alignement sur 64 pour maintenir la correspondance entre les vidéos RGB et de contrôle, tandis que `auto` reprend les dimensions et le rapport d’aspect de la source dans les limites de LTX.
preserve_original_videofacultatif
Typeboolean
Par défautfalse
Mode de conservation de la vidéo d’origine, 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 ; lorsqu’il est activé, la génération commence à 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 valeurs faibles préservent davantage de pixels d’origine.
image_urlfacultatif image
Typeurl · image
Style d’ancrage d’image ou identité de personnage facultatif utilisé comme image clé de la première image.
mid_image_urlfacultatif
Typeurl · image
Apparence d’ancrage d’image facultative vers le milieu du clip, en complément 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 emplacement différent de celui 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 faibles autorisent 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 valeurs plus faibles en préservent davantage, par exemple 0.5 en conserve 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 pour des dimensions de classe 720p, et davantage pour des tailles inférieures.
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 rapport d’aspect 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 ; laisser ce réglage inchangé utilise 15.
guidance_scalefacultatif
Typenumber
Par défaut1
1 – 20
Ajustez le classifier-free guidance avec 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
Option de piste audio pour le MP4 renvoyé : désactivée, elle produit un fichier vidéo sans audio ; activée, elle 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 l'activation de la vérification de sécurité.
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.
obligatoire 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 sur notre stockage : conservée indéfiniment (facturation par Go-mois) ou 7 jours gratuitement, selon le réglage de votre compte ou ?storage=.
Une structure identique pour chaque modèletype, url, content_type, width, height et duration, pour les images, les vidéos et l'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
integerSeed effectivement 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 au format Markdown est disponible à l'adresse https://doitong.com/fr-FR/developers/models/ltx-2.3-quality/reference-video-to-video.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt