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

Luma Ray 3.2 Image to Video

Ενσωμάτωση

id μοντέλου luma/agent/ray/v3.2/image-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/image-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"
  }'

# 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,15 $ 150 πιστώσεις API · ≈ 16,10 ₽ Εκτέλεση σε αυτήν τη σελίδα

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

Image-to-video Ray 3.2 με τελικό καρέ ή έως 64 καρέ-κλειδιά, επανάληψη και προαιρετική έξοδο HDR/EXR

Luma AI · Βίντεο

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

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

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

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

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

Text περιγραφή της σκηνής ή της κίνησης προς δημιουργία.

duration 5 s

Διάρκεια παραγόμενου βίντεο. Μία μόνο άγκυρα image_url / end_image_url δεν υποστηρίζει 10s· αυτή η διάρκεια απαιτεί πολλαπλά βασικά καρέ μέσω keyframes / keyframe_indexes.

aspect_ratio προεπιλογή 16:9

Αναλογία διαστάσεων του τελικού βίντεο.

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

Ανάλυση της εξόδου βίντεο.

Για προχωρημένους image · end_image · loop · enable_safety_checker · keyframes · keyframe_indexes
image_url
Αποθέστε ένα αρχείο ή

URL εικόνας πρώτου καρέ που παρέχεται μέσω image_url και επιτρέπει προαιρετικό συνοδευτικό end_image_url. Αυτή η λειτουργία αγκύρωσης αποκλείει τα βασικά καρέ· επιλέξτε μία λειτουργία, όχι και τις δύο.

end_image_url
Αποθέστε ένα αρχείο ή

Προαιρετικό URL εικόνας τελευταίου καρέ που επιτρέπει παρεμβολή από image_url σε end_image_url, ως εναλλακτική στη χρήση βασικών καρέ.

Παρέχετε 1–64 URL εικόνων ως οδηγούς image-to-video πολλαπλών βασικών καρέ, σε συνδυασμό με ισομήκη λίστα keyframe_indexes που καθορίζει τις θέσεις τους. Η χρήση keyframes επιτρέπει HDR και παραγωγή 10s, αλλά αποκλείει τα image_url, end_image_url και loop.

Θέσεις αγκύρωσης σε συνδυασμό με keyframes: η καταχώριση [i] τοποθετεί το keyframes[i] στην έξοδο και οι δύο πίνακες πρέπει να έχουν ίσο μήκος. Οι θέσεις πρέπει να είναι διακριτές και μη αρνητικές· duration × 24fps δίνει εύρη 0–120 για 5s και 0–240 για 10s.

POST /run/luma/agent/ray/v3.2/image-to-video?wait=20 προσφορά → 0,15 $
# 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/image-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"
  }'

# 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 Image to Video

Εφαρμόζει animation στο `image_url` ως πρώτο καρέ, προαιρετικά με `end_image_url`, ή χρησιμοποιεί `keyframes` με `keyframe_indexes` (1 έως 64). Οι αναλογίες διαστάσεων κυμαίνονται από 3:4 έως 21:9, η ανάλυση είναι 540p, 720p ή 1080p και το `duration` είναι 5s ή 10s, με τα 10s να απαιτούν καρέ-κλειδιά. Τα `loop`, `hdr` και `exr_export` είναι διαθέσιμα υπό τις αναφερόμενες προϋποθέσεις. Το όριο prompt είναι 6000 χαρακτήρες.

Παράμετροι

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

ΌνομαΤύπος ΠροεπιλογήΕπιτρεπόμενο Περιγραφή
promptαπαιτείται
Τύποςstring
≤ 6.000 χαρακτήρες
Text περιγραφή της σκηνής ή της κίνησης προς δημιουργία.
image_urlπροαιρετικό image
Τύποςurl · image
URL εικόνας πρώτου καρέ που παρέχεται μέσω image_url και επιτρέπει προαιρετικό συνοδευτικό end_image_url. Αυτή η λειτουργία αγκύρωσης αποκλείει τα βασικά καρέ· επιλέξτε μία λειτουργία, όχι και τις δύο.
end_image_urlπροαιρετικό end_image
Τύποςurl · image
Προαιρετικό URL εικόνας τελευταίου καρέ που επιτρέπει παρεμβολή από image_url σε end_image_url, ως εναλλακτική στη χρήση βασικών καρέ.
aspect_ratioπροαιρετικό
Τύποςenum
Προεπιλογή16:9
3:44:31:19:1616:921:9
Αναλογία διαστάσεων του τελικού βίντεο.
resolutionπροαιρετικό
Τύποςenum
Προεπιλογή540p
540p720p1080p
Ανάλυση της εξόδου βίντεο.
durationπροαιρετικό
Τύποςenum
Προεπιλογή5s
5s10s
Διάρκεια παραγόμενου βίντεο. Μία μόνο άγκυρα image_url / end_image_url δεν υποστηρίζει 10s· αυτή η διάρκεια απαιτεί πολλαπλά βασικά καρέ μέσω keyframes / keyframe_indexes.
loopπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Παραγωγή βρόχου χωρίς εμφανή ραφή, περιορισμένη σε έξοδο τυπικού δυναμικού εύρους· ο καθορισμός τελικού καρέ ή βασικών καρέ καθιστά αυτή την επιλογή μη διαθέσιμη.
hdrπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Κωδικοποίηση HDR για έξοδο MP4, διαθέσιμη σε 720p ή 1080p για λογαριασμούς με πρόσβαση HDR. Για τη χρήση της πρέπει να είναι απενεργοποιημένη η επανάληψη.
exr_exportπροαιρετικό
Τύποςboolean
Προεπιλογήfalse
Πρόσθετη εξαγωγή EXR που συνοδεύει το MP4, διαθέσιμη μόνο με πρόσβαση HDR και hdr=true.
keyframesπροαιρετικό
Τύποςstring[]
≤ 64 στοιχεία
Παρέχετε 1–64 URL εικόνων ως οδηγούς image-to-video πολλαπλών βασικών καρέ, σε συνδυασμό με ισομήκη λίστα keyframe_indexes που καθορίζει τις θέσεις τους. Η χρήση keyframes επιτρέπει HDR και παραγωγή 10s, αλλά αποκλείει τα image_url, end_image_url και loop.
keyframe_indexesπροαιρετικό
Τύποςinteger[]
≤ 64 στοιχεία
Θέσεις αγκύρωσης σε συνδυασμό με keyframes: η καταχώριση [i] τοποθετεί το keyframes[i] στην έξοδο και οι δύο πίνακες πρέπει να έχουν ίσο μήκος. Οι θέσεις πρέπει να είναι διακριτές και μη αρνητικές· duration × 24fps δίνει εύρη 0–120 για 5s και 0–240 για 10s.
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/image-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": 150,
    "usd": "0.15",
    "charged": 150,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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/image-to-video.md. Όλα τα μοντέλα και οι οδηγοί: https://doitong.com/developers/llms.txt