Passer 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,27 ₽ 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 des préréglages, contrôles et images clés d'intensité d'édition

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.

•requis 88 / 6000

Instructions textuelles pour modifier la vidéo source.

•requis 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 facultatif de la première image de la vidéo modifiée, fourni sous forme d’URL d’image ; s’il est omis, 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.

Identifiant opaque facultatif identifiant l’utilisateur final qui envoie la requête.

Réglage de préservation de la source pour les modifications, disponible uniquement lorsque auto_controls n’est pas utilisé ; l’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 keyframes avec un tableau keyframe_indexes de même longueur pour associer chaque image à la position de son image dans la vidéo source ; 64 URL maximum sont autorisées.

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

Correspondance des images source associée une à une 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 un `video_url` selon un `prompt`, avec éventuellement `start_image_url` 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 options 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
promptrequis
Typestring
≤ 6 000 caractères
Instructions textuelles pour modifier la vidéo source.
video_urlrequis video
Typeurl · video
URL de la vidéo à modifier.
userfacultatif
Typestring | null
Identifiant opaque facultatif identifiant l’utilisateur final qui envoie la requête.
start_image_urlfacultatif image
Typeurl · image
Remplacement facultatif de la première image de la vidéo modifiée, fourni sous forme d’URL d’image ; s’il est omis, 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
Réglage de préservation de la source pour les modifications, disponible uniquement lorsque auto_controls n’est pas utilisé ; l’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 de la pose, de la profondeur, des normales, de la trajectoire et du visage. L’utilisation de ces contrôles exclut auto_controls.
controls.posefacultatif
Typeobject
Conditionnement fondé 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 pour conserver la valeur par défaut, choisissez 'coarse' pour davantage de liberté ou utilisez 'precise' pour suivre étroitement la pose source.
controls.depthfacultatif
Typeobject
Conditionnement fondé 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
Réglage du flou de profondeur, laissé indéfini pour conserver la valeur par défaut ou augmenté pour donner davantage de liberté à la géométrie.
controls.normalsfacultatif
Typeobject
Conditionnement fondé 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
Réglage d’augmentation des normales de surface ; omettez-le pour conserver la valeur par défaut ou augmentez-le pour permettre une réinterprétation plus importante de la géométrie de surface.
controls.trajectoryfacultatif
Typeobject
Conditionnement fondé 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
Réglage 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 fondé 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 keyframes avec un tableau keyframe_indexes de même longueur pour associer chaque image à la position de son image dans la vidéo source ; 64 URL maximum sont autorisées.
keyframe_indexesfacultatif
Typeinteger[]
≤ 64 éléments
Correspondance des images source associée une à une 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é.
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": "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 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.
exr_file
object {url, content_type, file_name, file_size} | nullFichier EXR associé au format exporté par 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 à https://doitong.com/fr/developers/models/luma/agent/ray/v3.2/video-to-video.md. Tous les modèles et guides : https://doitong.com/developers/llms.txt