Accéder au contenu

Luma Ray 3.2 Video to Video

Intégrer

Identifiant du modèle luma/agent/ray/v3.2/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/luma/agent/ray/v3.2/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"

Cette requête: 0,72 $ 720 crédits API · ≈ 77,37 ₽ L'exécuter sur cette page

Obtenir une clé API
Luma AI Vidéo vers vidéo Synchronisation labiale5–10 sjusqu'à 1080p #stylized#transform#lipsync

Édition vidéo Ray 3.2 qui restyle une vidéo source avec préréglages d’intensité, contrôles et images clés

Luma AI · 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 88 / 6000

Instructions textuelles pour modifier la vidéo source.

•obligatoire video_url
Déposez un fichier ou

URL de la vidéo à modifier.

duration 5 s

Durée de la vidéo après modification.

resolution par défaut 540p

Résolution de sortie après modification.

Avancé image · user · edit_strength · auto_controls · enable_safety_checker · keyframes · controls · keyframe_indexes
start_image_url
Déposez un fichier ou

Remplacement de la première image de la vidéo modifiée, fourni sous forme d'URL d'image facultative ; en son absence, le modèle déduit cette image de la vidéo source. Par exemple, fournir une image d'ouverture restylée issue de la source peut guider l'apparence de la modification.

ID opaque facultatif identifiant l'utilisateur final qui envoie la requête.

Paramètre de préservation de la source pour les modifications, disponible uniquement lorsque auto_controls n'est pas utilisé ; son omission sélectionne la valeur par défaut du modèle. Du plus grand écart à l'adhérence la plus proche, les options sont 'reimagine_*', 'flex_*' pour un résultat équilibré et 'adhere_*'.

Guides de modification à plusieurs images clés fournis sous forme d'URL d'images au lieu de start_image_url. Fournissez les images clés avec un tableau keyframe_indexes de même longueur afin d'ancrer chaque image à la position de son image dans la vidéo source ; 64 URL au maximum sont autorisées.

Alternative détaillée à edit_strength qui configure séparément le conditionnement pour la pose, la profondeur, les normales, la trajectoire et le visage. L'utilisation de ces contrôles exclut auto_controls.

Correspondance des images source associée individuellement aux images clés : l'entrée [i] indique la position d'ancrage de keyframes[i]. Les deux tableaux doivent avoir la même longueur et les positions doivent être distinctes et non négatives.

POST /run/luma/agent/ray/v3.2/video-to-video?wait=20 devis → 0,72 $
# 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/luma/agent/ray/v3.2/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 Luma Ray 3.2 Video to Video

Modifie une `video_url` selon un `prompt`, avec un `start_image_url` facultatif pour guider la première image. `edit_strength` propose les niveaux adhere, flex et reimagine de 1 à 3, tandis que `auto_controls` ou un objet `controls` offrent d’autres modes de conditionnement. Jusqu’à 64 `keyframes` peuvent être ancrées avec `keyframe_indexes`. La sortie va de 540p à 1080p, en 5s ou 10s, avec `hdr` et `exr_export` facultatifs.

Paramètres

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

NomType Par défautAutorisé Description
promptobligatoire
Typestring
≤ 6 000 caractères
Instructions textuelles pour modifier la vidéo source.
video_urlobligatoire video
Typeurl · video
URL de la vidéo à modifier.
userfacultatif
Typestring | null
ID opaque facultatif identifiant l'utilisateur final qui envoie la requête.
start_image_urlfacultatif image
Typeurl · image
Remplacement de la première image de la vidéo modifiée, fourni sous forme d'URL d'image facultative ; en son absence, le modèle déduit cette image de la vidéo source. Par exemple, fournir une image d'ouverture restylée issue de la source peut guider l'apparence de la modification.
resolutionfacultatif
Typeenum
Par défaut540p
540p720p1080p
Résolution de sortie après modification.
durationfacultatif
Typeenum
Par défaut5s
5s10s
Durée de la vidéo après modification.
edit_strengthfacultatif
Typeenum
adhere_1adhere_2adhere_3flex_1flex_2flex_3reimagine_1reimagine_2reimagine_3
Paramètre de préservation de la source pour les modifications, disponible uniquement lorsque auto_controls n'est pas utilisé ; son omission sélectionne la valeur par défaut du modèle. Du plus grand écart à l'adhérence la plus proche, les options sont 'reimagine_*', 'flex_*' pour un résultat équilibré et 'adhere_*'.
auto_controlsfacultatif
Typeboolean
Par défautfalse
Conditionnement automatique de la modification : le modèle utilise la vidéo source pour déterminer le calendrier au lieu d'accepter edit_strength avec cette option.
hdrfacultatif
Typeboolean
Par défautfalse
Encodage HDR pour une sortie MP4 en 720p ou 1080p, disponible uniquement pour les comptes disposant de l'accès HDR.
exr_exportfacultatif
Typeboolean
Par défautfalse
Export EXR supplémentaire accompagnant le MP4, disponible uniquement avec l'accès HDR et hdr=true.
controlsfacultatif
Typeobject
Alternative détaillée à edit_strength qui configure séparément le conditionnement pour la pose, la profondeur, les normales, la trajectoire et le visage. L'utilisation de ces contrôles exclut auto_controls.
controls.posefacultatif
Typeobject
Conditionnement basé sur la pose ou le squelette.
controls.pose.enabledfacultatif
Typeboolean
Par défauttrue
Activation du conditionnement de la pose ou du squelette pendant la modification.
controls.pose.strengthfacultatif
Typeenum
precisecoarse
Sélection de la précision du conditionnement de la pose : omettez la valeur pour conserver la valeur par défaut, choisissez 'coarse' pour plus de liberté ou utilisez 'precise' pour suivre étroitement la pose source.
controls.depthfacultatif
Typeobject
Conditionnement basé sur la profondeur ou la géométrie de la scène.
controls.depth.enabledfacultatif
Typeboolean
Par défauttrue
Activation du conditionnement de la profondeur ou de la géométrie de la scène pendant la modification.
controls.depth.blurfacultatif
Typenumber | null
0 – 1
Paramètre de flou de profondeur, laissé non défini pour conserver la valeur par défaut ou augmenté pour donner davantage de liberté à la géométrie.
controls.normalsfacultatif
Typeobject
Conditionnement basé sur les normales de surface.
controls.normals.enabledfacultatif
Typeboolean
Par défauttrue
Activation du conditionnement des normales de surface pendant la modification.
controls.normals.augmentationfacultatif
Typenumber | null
0 – 1
Paramètre d'augmentation des normales de surface ; omettez-le pour conserver la valeur par défaut ou augmentez-le pour autoriser une réinterprétation plus importante de la géométrie de surface.
controls.trajectoryfacultatif
Typeobject
Conditionnement basé sur les trajectoires de mouvement.
controls.trajectory.enabledfacultatif
Typeboolean
Par défauttrue
Activation du conditionnement des trajectoires de mouvement pendant la modification.
controls.trajectory.sparsityfacultatif
Typenumber | null
0 – 1
Paramètre de parcimonie des trajectoires de mouvement ; omettez-le pour conserver la valeur par défaut ou augmentez-le pour réduire le nombre d'ancrages de mouvement utilisés.
controls.facefacultatif
Typeobject
Conditionnement basé sur l'identité faciale.
controls.face.enabledfacultatif
Typeboolean
Par défauttrue
Activation du conditionnement de l'identité faciale pendant la modification.
keyframesfacultatif
Typestring[]
≤ 64 éléments
Guides de modification à plusieurs images clés fournis sous forme d'URL d'images au lieu de start_image_url. Fournissez les images clés avec un tableau keyframe_indexes de même longueur afin d'ancrer chaque image à la position de son image dans la vidéo source ; 64 URL au maximum sont autorisées.
keyframe_indexesfacultatif
Typeinteger[]
≤ 64 éléments
Correspondance des images source associée individuellement aux images clés : l'entrée [i] indique la position d'ancrage de keyframes[i]. Les deux tableaux doivent avoir la même longueur et les positions doivent être distinctes et non négatives.
enable_safety_checkerfacultatif
Typeboolean
Par défauttrue
Le filtrage peut être assoupli en définissant false, si l'appelant est autorisé.
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": "luma/agent/ray/v3.2/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": 720,
    "usd": "0.72",
    "charged": 720,
    "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
    },
    "exr_file": {
      "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
    }
  },
  "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.
exr_file
object {url, content_type, file_name, file_size} | nullFichier EXR associé au format des exportations Luma : soit un fichier EXR, soit une archive ZIP. Il est généré lorsque exr_export vaut true.

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/luma/agent/ray/v3.2/video-to-video.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt