Μετάβαση στο περιεχόμενο

Luma Ray 3.2 Video to Video

Ενσωμάτωση

id μοντέλου 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"

Αυτό το αίτημα: 0,72 $ 720 πιστώσεις API · ≈ 77,27 ₽ Εκτέλεση σε αυτήν τη σελίδα

Λήψη κλειδιού API
Luma AI Βίντεο σε βίντεο Συγχρονισμός χειλιών5–10 sέως 1080p #stylized#transform#lipsync

Επεξεργασία βίντεο Ray 3.2 που αλλάζει το στυλ ενός βίντεο πηγής με προκαθορισμένες ρυθμίσεις έντασης, ελέγχους και καρέ-κλειδιά

Luma AI · Βίντεο

Το πρώτο σας αποτέλεσμα θα εμφανιστεί εδώ

Δημιουργήστε ένα αίτημα παρακάτω και εκτελέστε το με το κλειδί API σας. Οι έξοδοι αντιγράφονται στην αποθήκευσή μας και διατηρούνται για πάντα ή 7 ημέρες δωρεάν.

Δημιουργία αιτήματος

Τα στοιχεία ελέγχου δημιουργούνται από το σχήμα του μοντέλου. Ο κώδικας και η τιμή ενημερώνονται καθώς τα αλλάζετε.

•απαιτείται 88 / 6000

Οδηγίες κειμένου για την επεξεργασία του βίντεο προέλευσης.

•απαιτείται video_url
Αποθέστε ένα αρχείο ή

URL του βίντεο που επεξεργάζεται.

duration 5 s

Διάρκεια του βίντεο μετά την επεξεργασία.

resolution προεπιλογή 540p

Ανάλυση εξόδου μετά την επεξεργασία.

Για προχωρημένους image · user · edit_strength · auto_controls · enable_safety_checker · keyframes · controls · keyframe_indexes
start_image_url
Αποθέστε ένα αρχείο ή

Παράκαμψη πρώτου καρέ για το επεξεργασμένο βίντεο, που παρέχεται ως προαιρετικό URL εικόνας· όταν παραλείπεται, το μοντέλο παράγει αυτό το καρέ από το βίντεο προέλευσης. Για παράδειγμα, η παροχή μιας εικόνας έναρξης με διαφορετικό στυλ από την προέλευση μπορεί να καθοδηγήσει την εμφάνιση της επεξεργασίας.

Προαιρετικό αδιαφανές ID που αναγνωρίζει τον τελικό χρήστη που υποβάλλει το αίτημα.

Ρύθμιση διατήρησης προέλευσης για επεξεργασίες, διαθέσιμη μόνο όταν δεν χρησιμοποιείται το auto_controls· η παράλειψη επιλέγει την προεπιλογή του μοντέλου. Από τη μεγαλύτερη απόκλιση έως την πλησιέστερη τήρηση, οι επιλογές είναι 'reimagine_*', 'flex_*' για ισορροπημένο αποτέλεσμα και 'adhere_*'.

Οδηγοί επεξεργασίας πολλαπλών βασικών καρέ που παρέχονται ως URL εικόνων αντί για start_image_url. Παρέχετε keyframes μαζί με ισομήκη πίνακα keyframe_indexes για να καθηλώσετε κάθε εικόνα στη θέση καρέ του βίντεο προέλευσης· επιτρέπονται έως 64 URL.

Λεπτομερής εναλλακτική του edit_strength που ρυθμίζει ξεχωριστά τη συνθήκη για στάση, βάθος, καθέτους, τροχιά και πρόσωπο. Η χρήση αυτών των ελέγχων αποκλείει το auto_controls.

Αντιστοίχιση καρέ προέλευσης ένα προς ένα με keyframes: η καταχώριση [i] καθορίζει τη θέση αγκύρωσης για το keyframes[i]. Και οι δύο πίνακες πρέπει να έχουν ίσα μήκη και οι θέσεις πρέπει να είναι διακριτές και μη αρνητικές.

POST /run/luma/agent/ray/v3.2/video-to-video?wait=20 προσφορά → 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"

Εκτέλεση αυτού του αιτήματος

Το κλειδί σας παραμένει σε αυτό το πρόγραμμα περιήγησης: αποστέλλεται μόνο στο Doitong API και αποθηκεύεται (localStorage) μόνο αν ενεργοποιήσετε την επιλογή «Να απομνημονεύεται». Λήψη κλειδιού API

Σχετικά με το Luma Ray 3.2 Video to Video

Επεξεργάζεται ένα `video_url` σύμφωνα με `prompt`, με προαιρετικό `start_image_url` για καθοδήγηση του πρώτου καρέ. Το `edit_strength` προσφέρει επίπεδα adhere, flex και reimagine από 1 έως 3, ενώ τα `auto_controls` ή ένα αντικείμενο `controls` παρέχουν εναλλακτική συνθήκευση. Έως 64 `keyframes` μπορούν να αγκυρωθούν με `keyframe_indexes`. Η έξοδος είναι 540p έως 1080p, 5s ή 10s, με προαιρετικά `hdr` και `exr_export`.

Παράμετροι

Στείλτε είτε το κανονικό όνομα είτε το εγγενές όνομα, όχι και τα δύο. Κανονικά ονόματα

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
promptαπαιτείται
Τύποςstring
≤ 6.000 χαρακτήρες
Οδηγίες κειμένου για την επεξεργασία του βίντεο προέλευσης.
video_urlαπαιτείται video
Τύποςurl · video
URL του βίντεο που επεξεργάζεται.
userπροαιρετικό
Τύποςstring | null
Προαιρετικό αδιαφανές ID που αναγνωρίζει τον τελικό χρήστη που υποβάλλει το αίτημα.
start_image_urlπροαιρετικό image
Τύποςurl · image
Παράκαμψη πρώτου καρέ για το επεξεργασμένο βίντεο, που παρέχεται ως προαιρετικό URL εικόνας· όταν παραλείπεται, το μοντέλο παράγει αυτό το καρέ από το βίντεο προέλευσης. Για παράδειγμα, η παροχή μιας εικόνας έναρξης με διαφορετικό στυλ από την προέλευση μπορεί να καθοδηγήσει την εμφάνιση της επεξεργασίας.
resolutionπροαιρετικό
Τύποςenum
Προεπιλογή540p
540p720p1080p
Ανάλυση εξόδου μετά την επεξεργασία.
durationπροαιρετικό
Τύποςenum
Προεπιλογή5s
5s10s
Διάρκεια του βίντεο μετά την επεξεργασία.
edit_strengthπροαιρετικό
Τύποςenum
adhere_1adhere_2adhere_3flex_1flex_2flex_3reimagine_1reimagine_2reimagine_3
Ρύθμιση διατήρησης προέλευσης για επεξεργασίες, διαθέσιμη μόνο όταν δεν χρησιμοποιείται το auto_controls· η παράλειψη επιλέγει την προεπιλογή του μοντέλου. Από τη μεγαλύτερη απόκλιση έως την πλησιέστερη τήρηση, οι επιλογές είναι 'reimagine_*', 'flex_*' για ισορροπημένο αποτέλεσμα και 'adhere_*'.
auto_controlsπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Αυτόματη συνθήκη επεξεργασίας: το μοντέλο χρησιμοποιεί το βίντεο προέλευσης για να καθορίσει το χρονοδιάγραμμα, αντί να δέχεται edit_strength μαζί με αυτή την επιλογή.
hdrπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Κωδικοποίηση HDR για έξοδο MP4 σε 720p ή 1080p, διαθέσιμη μόνο σε λογαριασμούς με πρόσβαση HDR.
exr_exportπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Πρόσθετη εξαγωγή EXR που συνοδεύει το MP4, διαθέσιμη μόνο με πρόσβαση HDR και hdr=true.
controlsπροαιρετικό
Τύποςobject
Λεπτομερής εναλλακτική του edit_strength που ρυθμίζει ξεχωριστά τη συνθήκη για στάση, βάθος, καθέτους, τροχιά και πρόσωπο. Η χρήση αυτών των ελέγχων αποκλείει το auto_controls.
controls.poseπροαιρετικό
Τύποςobject
Συνθήκη βάσει στάσης ή σκελετού.
controls.pose.enabledπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Εναλλαγή για συνθήκη στάσης ή σκελετού κατά την επεξεργασία.
controls.pose.strengthπροαιρετικό
Τύποςenum
precisecoarse
Επιλογή ακρίβειας συνθήκης στάσης: παραλείψτε την για διατήρηση της προεπιλογής, επιλέξτε 'coarse' για μεγαλύτερη ελευθερία ή χρησιμοποιήστε 'precise' για στενή παρακολούθηση της στάσης προέλευσης.
controls.depthπροαιρετικό
Τύποςobject
Συνθήκη βάσει βάθους ή γεωμετρίας σκηνής.
controls.depth.enabledπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Εναλλαγή για συνθήκη βάθους ή γεωμετρίας σκηνής κατά την επεξεργασία.
controls.depth.blurπροαιρετικό
Τύποςnumber | null
0 – 1
Ρύθμιση θολώματος βάθους, που αν παραμείνει ακαθόριστη διατηρεί την προεπιλογή ή αν αυξηθεί παρέχει μεγαλύτερη ελευθερία στη γεωμετρία.
controls.normalsπροαιρετικό
Τύποςobject
Συνθήκη βάσει καθέτων επιφάνειας.
controls.normals.enabledπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Εναλλαγή για συνθήκη καθέτων επιφάνειας κατά την επεξεργασία.
controls.normals.augmentationπροαιρετικό
Τύποςnumber | null
0 – 1
Ρύθμιση ενίσχυσης καθέτων επιφάνειας· παραλείψτε την για διατήρηση της προεπιλογής ή αυξήστε την για μεγαλύτερη επανερμηνεία της γεωμετρίας επιφάνειας.
controls.trajectoryπροαιρετικό
Τύποςobject
Συνθήκη βάσει τροχιών κίνησης.
controls.trajectory.enabledπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Εναλλαγή για συνθήκη τροχιάς κίνησης κατά την επεξεργασία.
controls.trajectory.sparsityπροαιρετικό
Τύποςnumber | null
0 – 1
Ρύθμιση αραιότητας τροχιάς κίνησης· παραλείψτε την για διατήρηση της προεπιλογής ή αυξήστε την για μείωση του πλήθους αγκυρών κίνησης.
controls.faceπροαιρετικό
Τύποςobject
Συνθήκη βάσει ταυτότητας προσώπου.
controls.face.enabledπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Εναλλαγή για συνθήκη ταυτότητας προσώπου κατά την επεξεργασία.
keyframesπροαιρετικό
Τύποςstring[]
≤ 64 στοιχεία
Οδηγοί επεξεργασίας πολλαπλών βασικών καρέ που παρέχονται ως URL εικόνων αντί για start_image_url. Παρέχετε keyframes μαζί με ισομήκη πίνακα keyframe_indexes για να καθηλώσετε κάθε εικόνα στη θέση καρέ του βίντεο προέλευσης· επιτρέπονται έως 64 URL.
keyframe_indexesπροαιρετικό
Τύποςinteger[]
≤ 64 στοιχεία
Αντιστοίχιση καρέ προέλευσης ένα προς ένα με keyframes: η καταχώριση [i] καθορίζει τη θέση αγκύρωσης για το keyframes[i]. Και οι δύο πίνακες πρέπει να έχουν ίσα μήκη και οι θέσεις πρέπει να είναι διακριτές και μη αρνητικές.
enable_safety_checkerπροαιρετικό
Τύποςboolean
Προεπιλογήtrue
Ο έλεγχος μπορεί να χαλαρώσει με τη ρύθμιση false, εφόσον ο καλών είναι εξουσιοδοτημένος.
απαιτείται Κανονικό όνομα, επίσης αποδεκτό

Οι παράμετροι αρχείων δέχονται ένα δημόσιο URL https://, ένα URI data: έως 10 MB ή το file_url μιας μεταφόρτωσης. Αρχεία

Έξοδος

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"
  }
}
Τα αρχεία σας, η επιλογή σαςΚάθε outputs[].url είναι ένα αντίγραφο στην αποθήκευσή μας: διατηρείται για πάντα (χρέωση ανά GB-μήνα) ή 7 ημέρες δωρεάν, σύμφωνα με τη ρύθμιση του λογαριασμού σας ή ?storage=.
Ίδια μορφή σε κάθε μοντέλοtype, url, content_type, width, height και duration, τόσο για εικόνες όσο και για βίντεο και ήχο. Το output είναι το αντικείμενο αποτελέσματος του ίδιου του μοντέλου.
Πεδία εξόδου
video
object {url, content_type, file_name, file_size}Βίντεο που παράγεται από το μοντέλο.
exr_file
object {url, content_type, file_name, file_size} | nullΣυνοδευτικό EXR στη μορφή εξαγωγών Luma: είτε ένα αρχείο EXR είτε αρχείο ZIP. Παράγεται όταν το exr_export είναι true.

Περισσότερα μοντέλα: Βίντεο σε βίντεο

Για πράκτορες AI: αυτή η σελίδα σε Markdown βρίσκεται στη διεύθυνση https://doitong.com/el/developers/models/luma/agent/ray/v3.2/video-to-video.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt