Google: Veo 3.1
Το Veo 3.1 είναι το μοντέλο βίντεο της Google για σκηνές από κείμενο και εικόνα με παραγόμενο ήχο, καθοδηγούμενα ακραία καρέ και οπτικά στοιχεία αναφοράς. Το προφίλ παραγωγής του παρέχει κλιπ τεσσάρων, έξι ή οκτώ δευτερολέπτων στα 24 fps, με επιλογές εξόδου 720p, 1080p και 4K.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Veo 3.1 είναι το μοντέλο δημιουργίας βίντεο της Google για σύντομη οπτικοακουστική σκηνή από κείμενο ή περιγραφή με βάση εικόνα. Το προφίλ παραγωγής του υποστηρίζει δημιουργία από κείμενο, από εικόνα και με καθοδηγούμενα πρώτα/τελευταία καρέ, με παραγόμενο ήχο, αναφορές οπτικών στοιχείων και χωριστή ροή συνέχειας. Χρησιμοποιήστε το για ανάπτυξη κινηματογραφικής ιδέας, σύντομης αφήγησης προϊόντος ή οπτικού τμήματος με καθορισμένη σκηνή, δράση και ακουστική εμπειρία.
Περιγράψτε πρώτα το θέμα και το ορατό γεγονός. Καθορίστε το περιβάλλον, την ώρα της ημέρας και το φως και έπειτα την οπτική γωνία ή κίνηση κάμερας και το επιθυμητό οπτικό ύφος. Μια πρωτότυπη περιγραφή σκηνής θα μπορούσε να δείχνει γυάλινο δοχείο σε σκούρα επιφάνεια στούντιο, με αργή πλευρική κίνηση που αποκαλύπτει αντανάκλαση, ενώ ένας απαλός ήχος περιβάλλοντος συνοδεύει την αποκάλυψη. Κάθε οδηγία δίνει ορατό ή ακουστό χαρακτηριστικό που μπορεί να αξιολογηθεί στο ολοκληρωμένο αποτέλεσμα.
Το πλαίσιο προτροπών της Google αντιμετωπίζει θέμα, δράση, σκηνή, κάμερα και αισθητική ως χωριστά μέρη της περιγραφής. Χρησιμοποιήστε όσα υπηρετούν το πλάνο, αντί να προσθέτετε κάθε πιθανό προσδιορισμό. Γράψτε την οδηγία στα αγγλικά για το τεκμηριωμένο προφίλ προτροπών. Αν η σκηνή έχει αρκετές ενέργειες, δηλώστε τη σχέση τους και κρατήστε τες ανάλογες προς σύντομο κλιπ, ώστε μια αποκάλυψη ή αντίδραση να παραμένει ευανάγνωστη.
Μια αρχική εικόνα καθορίζει την εμφάνιση και σύνθεση της αρχής. Χρησιμοποιήστε την όταν ο χαρακτήρας, το προϊόν ή το περιβάλλον υπάρχει ήδη ως οπτικό αρχείο και περιγράψτε την κίνηση που πρέπει να εξελιχθεί από αυτό. Ένα τελευταίο καρέ προσθέτει σύνθεση στόχου για το τέλος. Προετοιμάστε ακραία καρέ που επικοινωνούν εύλογη μετάβαση και διατηρούν τις λεπτομέρειες που προσδιορίζουν το κύριο θέμα και εξετάστε κατόπιν την κίνηση μεταξύ τους μετά τη δημιουργία.
Οι αναφορές οπτικών στοιχείων υπηρετούν άλλο σκοπό: καθοδηγούν την εμφάνιση χαρακτήρα ή αντικειμένου σε νέα παραγόμενη σκηνή, ενώ τα ακραία καρέ ορίζουν συγκεκριμένες στιγμές της. Επιλέξτε αναφορές που δείχνουν τα σημαντικά οπτικά γνωρίσματα και κάντε σαφή τον ρόλο κάθε στοιχείου στην προτροπή. Η προδιαγραφή δημιουργίας βίντεο από εικόνες αναφοράς του μοντέλου παραγωγής χρησιμοποιεί έξοδο οκτώ δευτερολέπτων για αυτή τη ροή αναφορών, χωριστά από τη συνήθη επιλογή διάρκειας με βάση κείμενο.
Το συνηθισμένο προφίλ παραγωγής του κατασκευαστή δημιουργεί κλιπ τεσσάρων, έξι ή οκτώ δευτερολέπτων στα 24 καρέ ανά δευτερόλεπτο. Αναφέρει οριζόντιο κάδρο 16:9 και κάθετο 9:16, έως τέσσερα βίντεο εξόδου ανά προτροπή και αναλύσεις εξόδου 720p, 1080p και 4K. Η μορφή βίντεο εξόδου είναι MP4. Η προδιαγραφή από εικόνα δέχεται JPEG ή PNG, αναφέρει μέγιστο εικόνας εισόδου 20 MB και υποστηρίζει ρυθμίσεις εισόδου 720p/1080p. Επιλέξτε το προφίλ εξόδου για την επιθυμητή θέση και κρατήστε τη σύνθεση καρέ ευανάγνωστη σε αυτό το μέγεθος.
Ο εγγενής ήχος μπορεί να συνοδεύει την ορατή σκηνή. Προσδιορίστε προφορικές φράσεις, ατμόσφαιρα και ηχητικά εφέ ως μέρη της ίδιας περιγραφής, ονομάζοντας το θέμα ή γεγονός που παράγει καθένα. Μια οδηγία διαλόγου και μια οδηγία κάμερας απαντούν σε διαφορετικά ερωτήματα: η μία καθορίζει την ερμηνεία και η άλλη πώς τη βλέπει ο θεατής. Κρατήστε τα λόγια μέσα στον χρήσιμο χρόνο ομιλίας του κλιπ και ελέγξτε τον ήχο για καταληπτότητα και σχέση με τη δράση.
Για συνέχεια, ο κατασκευαστής παρέχει χωριστή ροή επέκτασης βίντεο. Ξεκινήστε από κατάλληλο παραγόμενο αρχικό κλιπ και περιγράψτε το επόμενο ορατό γεγονός ή αλλαγή στη σκηνή. Διατηρήστε το αρχικό και το συνεχιζόμενο τμήμα, ώστε η ένωσή τους να ελεγχθεί ως προς εμφάνιση, κίνηση και ήχο. Οι συνήθεις επιλογές διάρκειας και ανάλυσης νέας δημιουργίας δεν πρέπει να αντιμετωπίζονται ως καθολική σύμβαση για κάθε λειτουργία επέκτασης.
Μια αρνητική περιγραφή μπορεί να εστιάζει τις εξαιρέσεις στις οπτικές απαιτήσεις της εργασίας. Για σειρά παραλλαγών προϊόντος, κρατήστε σταθερά θέμα και σύνθεση αλλάζοντας μία δημιουργική κατεύθυνση, όπως φωτισμό ή απόσταση κάμερας. Καταγράψτε προτροπή, αναφορές και επιλεγμένες ρυθμίσεις μαζί με το αποτέλεσμα. Αυτό επιτρέπει σύγκριση χρήσιμης δημιουργικής διαφοράς αντί για συλλογή άσχετων δημιουργιών.
Το κανονικό προφίλ παραγωγής Veo 3.1 και το Veo 3.1 Fast έχουν διαφορετικά προφίλ ανάλυσης εξόδου. Το Fast αναφέρει 720p και 1080p· το κανονικό 3.1 αναφέρει επίσης 4K. Κρατήστε την επιλεγμένη έκδοση συνδεδεμένη με το αποτέλεσμα, χωρίς σιωπηρή αντικατάσταση αναγνωριστικού μοντέλου παραγωγής με παλαιότερο προφίλ Preview ή άλλη γενιά Veo. Τόσο η εμφάνιση θέματος όσο και η υποστηριζόμενη λειτουργία εξαρτώνται από την επιλεγμένη ροή.
Η δημιουργία είναι λειτουργία της οποίας το ολοκληρωμένο αποτέλεσμα παρέχει αρχεία βίντεο για αναπαραγωγή και μετέπειτα επεξεργασία. Κρατήστε τα επιστρεφόμενα αρχεία με τα αρχικά καρέ, τα στοιχεία αναφοράς και την περιγραφή τους και διατηρήστε τις παρεχόμενες πληροφορίες προέλευσης περιεχομένου. Εξετάστε κάθε πραγματική έξοδο για εμφάνιση θέματος, δράση, κάδρο, ήχο και τελική σύνθεση. Χρησιμοποιήστε το επιλεγμένο κλιπ ως δομικό στοιχείο παραγωγής, με τίτλους, μεταβάσεις ή άλλη τελική επεξεργασία να προστίθενται στο γύρω μοντάζ.
Ailoot Ultra · Βίντεο POST /v1/videos google/veo-3.1
google/veo-3.1Εισαγωγή
Το Veo 3.1 είναι το μοντέλο βίντεο της Google για σκηνές από κείμενο και εικόνα με παραγόμενο ήχο, καθοδηγούμενα ακραία καρέ και οπτικά στοιχεία αναφοράς. Το προφίλ παραγωγής του παρέχει κλιπ τεσσάρων, έξι ή οκτώ δευτερολέπτων στα 24 fps, με επιλογές εξόδου 720p, 1080p και 4K.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- Βίντεο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Βίντεο POST /v1/videos
- Είσοδος
text- Έξοδος
video- Μορφή εξόδου
- mp4
- Πλήθος εξόδων
- Έως 4 έξοδοςs
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια google/veo-3.1 | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Μέγιστο πλήθος byte UTF-8: 10.000 Απαιτείται περιεχόμενο πέρα από κενά διαστήματα: Ναι | Προεπιλογή— |
Πεδίοduration | Τύποςinteger | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια 4, 6, 8 | Προεπιλογή— |
Πεδίοresolution | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια 720p | Προεπιλογή— |
Πεδίοaspect_ratio | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια 16:9, 9:16 | Προεπιλογή— |
Πεδίοgenerate_audio | Τύποςboolean | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια false, true | Προεπιλογή— |
Συνδυασμοί υλικών εισόδου
Κείμενο σε βίντεο · Υποχρεωτικό: prompt
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, prompt, duration, resolution, aspect_ratio, generate_audio |
Παράμετροςadditional_properties | Σύμβασηfalse |
Παράμετροςparameters | Σύμβαση{"name":"model","type":"string","required":true,"enum":["google/veo-3.1"]}, {"name":"prompt","type":"string","required":true,"non_whitespace":true,"max_utf8_bytes":10000}, {"name":"duration","type":"integer","required":true,"enum":[4,6,8]}, {"name":"resolution","type":"string","required":true,"enum":["720p"]}, {"name":"aspect_ratio","type":"string","required":true,"enum":["16:9","9:16"]}, {"name":"generate_audio","type":"boolean","required":true,"enum":[false,true]} |
Παράμετροςmaterial_types | Σύμβασηtext |
Εναλλακτικά ονόματα μεθόδου: /v1/videos/generations, /videos, /videos/generations
Κύκλος ζωής: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Διατηρήστε ολόκληρη την απόκριση και τα αρχικά ID που επιστρέφονται.
Μην επανυποβάλετε ποτέ αίτημα δημιουργίας με άγνωστο αποτέλεσμα.
Τιμολόγηση
Πώς υπολογίζεται η τελική χρέωση
Οι εμφανιζόμενες τιμές χρησιμοποιούνται για την εκτίμηση του κόστους πριν από την παραγωγή. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική παραγωγή. Η μετρημένη διάρκεια της εξόδου και οι προβλεπόμενες ποσότητες δεν αποτελούν την τελική χρεώσιμη ποσότητα.
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Εκτιμώμενες χρεώσεις για σύγκριση
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Προβλεπόμενη ποσότητα | Δημιουργία ήχου | Ανάλυση | Μονάδα τιμολόγησης | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|---|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις token | Πίνακας χρεώσεωνΒασική χρέωση | Προβλεπόμενη ποσότητα— | Δημιουργία ήχου— | Ανάλυση— | Μονάδα τιμολόγησης— | Συνθήκες χρέωσης— | Χρέωση Είσοδος · Token εισόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Έξοδος · Token εξόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα · Εκτίμηση μόνο για σύγκριση — / 1K token |
| ΔιαμόρφωσηUltra | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταΖητούμενες ρυθμίσεις· μόνο εκτίμηση. | Δημιουργία ήχουΜε ήχο | Ανάλυση720p | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο εξόδου | Συνθήκες χρέωσης— | Χρέωση Έξοδος · Εκτιμώμενο δευτερόλεπτο βίντεο εξόδου · Εκτίμηση μόνο για σύγκριση $0.8 ανά δευτερόλεπτο βίντεο εξόδου Η εμφανιζόμενη τιμή εκτιμά το κόστος πριν από τη δημιουργία. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική δημιουργία. Η πραγματική διάρκεια βίντεο δεν αποτελεί τη χρεώσιμη ποσότητα. |
| ΔιαμόρφωσηΤιμή βίντεο | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Δημιουργία ήχου— | Ανάλυση— | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο | Συνθήκες χρέωσηςήχος: with_audio; ανάλυση: 4k | Χρέωση Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $1.2 ανά δευτερόλεπτο βίντεο |
| ΔιαμόρφωσηUltra | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταΖητούμενες ρυθμίσεις· μόνο εκτίμηση. | Δημιουργία ήχουΧωρίς ήχο | Ανάλυση720p | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο εξόδου | Συνθήκες χρέωσης— | Χρέωση Έξοδος · Εκτιμώμενο δευτερόλεπτο βίντεο εξόδου · Εκτίμηση μόνο για σύγκριση $0.4 ανά δευτερόλεπτο βίντεο εξόδου Η εμφανιζόμενη τιμή εκτιμά το κόστος πριν από τη δημιουργία. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική δημιουργία. Η πραγματική διάρκεια βίντεο δεν αποτελεί τη χρεώσιμη ποσότητα. |
| ΔιαμόρφωσηΤιμή βίντεο | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Δημιουργία ήχου— | Ανάλυση— | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο | Συνθήκες χρέωσηςήχος: without_audio; ανάλυση: 4k | Χρέωση Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $0.8 ανά δευτερόλεπτο βίντεο |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Δημιουργία ήχου— | Ανάλυση— | Μονάδα τιμολόγησης— | Συνθήκες χρέωσης— | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $1.6 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Στοιχεία τιμοκαταλόγου αναφοράς
Οι πίνακες αναφοράς του μοντέλου δεν αλλάζουν την επιλογή μεθόδου, τις εκτιμήσεις τιμής ή τις χρεώσεις. Οι εφαρμοζόμενες χρεώσεις χρησιμοποιούν τις τιμές της επιλεγμένης μεθόδου Ailoot.
Τιμές αναφοράς για διαμορφώσεις βίντεο
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςήχος: with_audio | Χρέωση Έξοδος · Τιμή βίντεο $0.8 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςήχος: with_audio; ανάλυση: 4k | Χρέωση Έξοδος · Τιμή βίντεο $1.2 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςήχος: without_audio | Χρέωση Έξοδος · Τιμή βίντεο $0.4 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςήχος: without_audio; ανάλυση: 4k | Χρέωση Έξοδος · Τιμή βίντεο $0.8 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
Παραδείγματα αιτημάτων
Ailoot Ultra · Βίντεο
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/veo-3.1", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}')
Path('request.json').write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · Βίντεο
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Έλεγχος κατάστασης εργασίας
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Άλλες ανακτήσεις περιεχομένου
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Αποθηκεύστε κάθε ολοκληρωμένο βίντεο ή αρχείο που επιστρέφεται· ανακτήστε κάθε πραγματικό URL αρχείου που επιστρέφεται.
Διατηρήστε κάθε ολοκληρωμένο υπογεγραμμένο URL του data[] που σας ανήκει και όλα τα μεταδεδομένα κατάστασης. Αποθηκεύστε κάθε έξοδο, μαζί με τον παραγόμενο ήχο της. Έγκυρο ηχητικό κομμάτι AAC μπορεί να υπάρχει ακόμη και με generate_audio=false· διατηρήστε ολόκληρο το αρχικό MP4 μαζί με αυτόν τον ήχο.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διαβάστε την υπάρχουσα αρχική εργασία· μην επανυποβάλετε ποτέ αποστολή με άγνωστο αποτέλεσμα.
Μέγιστο πλήθος εξόδων: 4.
Πεδία απάντησης
| Πεδίο | Τύπος | Σημασία |
|---|---|---|
Πεδίοid | Τύποςstring | Σημασία— |
Πεδίοobject | Τύποςstring | Σημασία— |
Πεδίοmodel | Τύποςstring | Σημασία— |
Πεδίοstatus | Τύποςstring | Σημασία— |
Πεδίοdata[] | Τύποςsigned content URL | Σημασία— |
Πεδίοcharge_pending_check | Τύποςboolean | Σημασία— |
Πεδίοerror.code | Τύποςstring | Σημασία— |
Πεδίοerror.message | Τύποςstring | Σημασία— |
Πεδίοoperation_id | Τύποςstring | ΣημασίαΑρχική απόκριση κατάστασης ή περιεχομένου HTTP503 result_pending_check: το ίδιο αρχικό δημόσιο ID βίντεο ως id. |
Πεδίοerror.type | Τύποςstring | Σημασίαserver_error σε HTTP503 result_pending_check. |
Σφάλματα και επόμενα βήματα
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΗ ανάγνωση του ακατέργαστου σώματος αιτήματος αποτυγχάνει πριν από την ανάλυση του προφίλ βίντεο | Επόμενο βήμαΔιατηρήστε την απόκριση που επιστρέφεται και διορθώστε το μη αναγνώσιμο σώμα αιτήματος. |
Απάντηση422 · price_unavailable | ΣυνθήκηΑποτυγχάνει η ανάλυση του ακριβούς προφίλ βίντεο ή το πλήρες αναλυμένο προφίλ δεν διαθέτει έτοιμη κάρτα με την ακριβή τιμή | Επόμενο βήμαΔιατηρήστε την απόκριση· χρησιμοποιήστε το πλήρες, ακριβές προφίλ που έχει άδεια πρόσβασης και τη δημοσιευμένη κάρτα του. Αυτός ο κλάδος εκτελείται πριν από αποστολή στον πάροχο. |
Απάντηση409 · video_not_ready | ΣυνθήκηΤο περιεχόμενο του αρχικού αποτελέσματος δεν είναι ακόμη διαθέσιμο | Επόμενο βήμαΕλέγχετε περιοδικά το αρχικό ID που επιστρέφεται και τηρείτε το Retry-After. |
Απάντησηserver_error | ΣυνθήκηΗ απόκριση που επιστράφηκε αναφέρει ότι η λειτουργία ή το αποτέλεσμα χρειάζεται έλεγχο | Επόμενο βήμαΔιατηρήστε το αρχικό ID της λειτουργίας/εργασίας που επιστράφηκε, τις κεφαλίδες του αιτήματος και την απόκριση· συνεχίστε με τις υποστηριζόμενες αναγνώσεις αυτής της αρχικής λειτουργίας. Μην υποβάλετε ξανά το αίτημα δημιουργίας. |
Απάντηση503 · result_pending_check | ΣυνθήκηGET αρχικής κατάστασης ή περιεχομένου: η εργασία δεν έχει δημοσιευτεί, η αρχική εργασία δεν είναι failed/cancelled/expired και η τοπική κατάσταση είναι unknown ή η κατάσταση της αρχικής εργασίας είναι completed. | Επόμενο βήμαΔιατηρήστε τα αρχικά id και operation_id (το ίδιο δημόσιο ID βίντεο), την απόκριση και τις κεφαλίδες· διαβάστε μόνο την αρχική κατάσταση ή περιεχόμενο. Μην υποβάλετε ποτέ νέο αίτημα δημιουργίας. |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra google/veo-3.1
Εναλλακτικές διαδρομές μεθόδων
/v1/videos/generations, /videos, /videos/generations
Σχετικά ID μοντέλων
FAQ · Google: Veo 3.1
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/videos·google/veo-3.1:text→video- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/videos·google/veo-3.1:model,prompt,duration,resolution,aspect_ratio,generate_audio