Google: Veo 3.1 Fast
Το Veo 3.1 Fast είναι το μοντέλο βίντεο της Google για σύντομες σκηνές από κείμενο ή εικόνα με παραγόμενο ήχο. Το προφίλ παραγωγής του επιστρέφει κλιπ MP4 τεσσάρων, έξι ή οκτώ δευτερολέπτων στα 24 fps, με έξοδο 720p ή 1080p και καθοδηγούμενα αρχικά ή τελικά καρέ.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Veo 3.1 Fast είναι το γρήγορο προφίλ δημιουργίας βίντεο της Google για σύντομη σκηνή που περιγράφεται σε κείμενο ή καθορίζεται από εικόνα. Συνδυάζει το οπτικό πλάνο με παραγόμενο ήχο και υποστηρίζει καθοδηγούμενα αρχικά και τελικά καρέ. Χρησιμοποιήστε το για ανάπτυξη ιδέας σκηνής, προετοιμασία σύντομων δημιουργικών παραλλαγών ή δημιουργία συμπαγούς οπτικοακουστικού τμήματος με σαφή δράση και οπτική κατεύθυνση.
Χτίστε την περιγραφή γύρω από θέμα, δράση και περιβάλλον. Προσθέστε κατόπιν το κάδρο, την κίνηση κάμερας, τον φωτισμό και την οπτική απόδοση που κάνουν χρήσιμο το πλάνο. Μια πρωτότυπη περιγραφή προϊόντος θα μπορούσε να δείχνει μικρό κεραμικό φωτιστικό σε ξύλινο γραφείο, με την κάμερα να πλησιάζει αργά καθώς ανάβει το φως και έναν ήσυχο ήχο διακόπτη να συνοδεύει τη δράση. Το θέμα και το ορατό γεγονός περιγράφουν την εικόνα· η ηχητική κατεύθυνση περιγράφει την ακουστική εμπειρία.
Γράψτε τη σκηνοθετική οδηγία στα αγγλικά, όπως ορίζεται στο προφίλ προτροπών του παραγωγού. Κρατήστε την κύρια δράση ανάλογη με τη διάρκεια κλιπ και διακρίνετε την κίνηση κάμερας από εκείνη του θέματος. Ένα γενικό εισαγωγικό πλάνο, ένα κοντινό υφής και ένα πλάνο παρακολούθησης κινούμενου αντικειμένου απαντούν σε διαφορετικά δημιουργικά ερωτήματα. Επιλέξτε την όψη που επικοινωνεί την επιθυμητή λεπτομέρεια, αντί να συνδυάζετε άσχετες οδηγίες κάμερας σε ένα σύντομο πλάνο.
Για σκηνή από εικόνα, προετοιμάστε καθαρή αρχική εικόνα που ήδη καθορίζει εμφάνιση και σύνθεση. Η περιγραφή κίνησης μπορεί κατόπιν να επικεντρωθεί στο γεγονός που ακολουθεί. Ένα τελικό καρέ μπορεί να δίνει οπτικό προορισμό για τη μετάβαση. Κρατήστε συνεπείς τις σημαντικές λεπτομέρειες θέματος και το ύφος μεταξύ των καρέ ή περιγράψτε ρητά τον επιθυμητό μετασχηματισμό. Ελέγξτε την ίδια τη μετάβαση, μαζί με την αρχική και τελική εικόνα της.
Το προφίλ παραγωγής του κατασκευαστή υποστηρίζει κλιπ τεσσάρων, έξι ή οκτώ δευτερολέπτων, οριζόντιο κάδρο 16:9 ή κάθετο 9:16 και έως τέσσερα βίντεο εξόδου ανά προτροπή. Η έξοδος Fast είναι 720p ή 1080p, στα 24 καρέ ανά δευτερόλεπτο, σε μορφή MP4. Το προφίλ από εικόνα δέχεται JPEG ή PNG, αναφέρει μέγιστο μέγεθος εικόνας εισόδου 20 MB και υποστηρίζει ρυθμίσεις εισόδου 720p/1080p. Προετοιμάστε τη σύνθεση για τον επιθυμητό προσανατολισμό και κρατήστε την είσοδο μέσα σε αυτό το όριο εικόνας.
Ο ήχος μπορεί να αποτελεί μέρος της παραγόμενης σκηνής. Περιγράψτε κάθε προφορική φράση, περιβαλλοντικό ήχο ή σχετικό εφέ μαζί με την ορατή δράση, προσδιορίζοντας το θέμα που πρέπει να μιλά και το γεγονός που πρέπει να παράγει ήχο. Κρατήστε τον διάλογο αρκετά σύντομο για την επιθυμητή ερμηνεία και διακρίνετέ τον από ατμόσφαιρα ή μουσική. Η δημιουργία ήχου ακολουθεί τη γραπτή περιγραφή σκηνής· ηχογράφηση δεν περιλαμβάνεται στις τεκμηριωμένες συνήθεις εισόδους αυτού του προφίλ.
Το τρέχον προφίλ παραγωγής αναφέρει επίσης δημιουργία με αναφορές οπτικών στοιχείων και επέκταση βίντεο. Οι αναφορές καθοδηγούν την εμφάνιση θέματος ή αντικειμένου, ενώ τα ακραία καρέ καθοδηγούν την αρχική και τελική σύνθεση. Επιλέξτε υλικό αναφοράς με σαφή ρόλο στη σκηνή, αντί να αντιμετωπίζετε κάθε εικόνα ως εναλλάξιμο έλεγχο. Για κλιπ που συνεχίζεται, επιλέξτε τη χωριστή ροή επέκτασης και περιγράψτε τι πρέπει να συμβεί μετά την υπάρχουσα δράση· ο χειρισμός εισόδου της διαφέρει από νέο πλάνο με βάση κείμενο.
Μια αρνητική περιγραφή μπορεί να προσδιορίζει περιεχόμενο ή οπτικές αποδόσεις που θέλετε να αποφύγετε. Κρατήστε την κύρια προτροπή εστιασμένη στην επιθυμητή σκηνή και κάντε τις εξαιρέσεις συγκεκριμένες για την εργασία. Για παραλλαγή προϊόντος, διατηρήστε θέμα και κάδρο αλλάζοντας μία λεπτομέρεια, όπως κατεύθυνση φωτός ή απόδοση υλικού. Κρατήστε τις ρυθμίσεις και το σύνολο αναφορών όταν συγκρίνετε αποτελέσματα, ώστε η δημιουργική διαφορά να παραμένει σαφής.
Το Veo 3.1 Fast και το κανονικό προφίλ Veo 3.1 παραμένουν διαφορετικές επιλογές. Η τεκμηριωμένη έξοδος παραγωγής Fast είναι 720p/1080p· το κανονικό προφίλ αναφέρει επίσης 4K. Κρατήστε την επιλεγμένη έκδοση και τις ρυθμίσεις εξόδου με το παραδοτέο, αντί να αντιμετωπίζετε ένα αναγνωριστικό Preview ή άλλη έκδοση Veo ως αυτόματο συνώνυμο αυτού του προφίλ παραγωγής.
Η ροή δημιουργεί λειτουργία παραγωγής και διαθέτει τα επιστρεφόμενα αρχεία βίντεο μετά την ολοκλήρωση. Κρατήστε κάθε πραγματική έξοδο που επιλέγεται για έλεγχο μαζί με την περιγραφή, τα αρχικά καρέ και τις σχετικές ρυθμίσεις. Το αναγνωριστικό λειτουργίας είναι καταγραφή της δημιουργίας· το ολοκληρωμένο αρχείο MP4 είναι αυτό που μπορεί να αναπαραχθεί και να χρησιμοποιηθεί στο μοντάζ. Διατηρήστε μαζί με το βίντεο κάθε παρεχόμενο μεταδεδομένο προέλευσης περιεχομένου.
Ελέγξτε την εμφάνιση θέματος, τη ζητούμενη δράση, τον χειρισμό κάμερας και τον ήχο σε όλο το κλιπ. Ελέγξτε την καταληπτότητα διαλόγου και τη σχέση ήχου με ορατά γεγονότα πριν το χρησιμοποιήσετε σε μεγαλύτερη σύνθεση. Το χρήσιμο αποτέλεσμα μπορεί να είναι πλάνο ιδέας, αποκάλυψη προϊόντος ή σύντομο αφηγηματικό τμήμα, με μεταγενέστερους τίτλους, μεταβάσεις και άλλη επεξεργασία να προστίθενται στη γύρω ροή παραγωγής.
Ailoot Ultra · Βίντεο POST /v1/videos google/veo-3.1-fast
google/veo-3.1-fastΕισαγωγή
Το Veo 3.1 Fast είναι το μοντέλο βίντεο της Google για σύντομες σκηνές από κείμενο ή εικόνα με παραγόμενο ήχο. Το προφίλ παραγωγής του επιστρέφει κλιπ MP4 τεσσάρων, έξι ή οκτώ δευτερολέπτων στα 24 fps, με έξοδο 720p ή 1080p και καθοδηγούμενα αρχικά ή τελικά καρέ.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- Βίντεο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Βίντεο POST /v1/videos
- Είσοδος
text- Έξοδος
video- Μορφή εξόδου
- mp4
- Πλήθος εξόδων
- Έως 4 έξοδοςs
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια google/veo-3.1-fast | Προεπιλογή— |
Πεδίο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-fast"]}, {"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 |
| ΔιαμόρφωσηΤιμή βίντεο | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Δημιουργία ήχου— | Ανάλυση— | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο | Συνθήκες χρέωσηςήχος: with_audio | Χρέωση Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $0.24 ανά δευτερόλεπτο βίντεο |
| ΔιαμόρφωσηΤιμή βίντεο | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Δημιουργία ήχου— | Ανάλυση— | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο | Συνθήκες χρέωσηςήχος: with_audio; ανάλυση: 4k | Χρέωση Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $0.6 ανά δευτερόλεπτο βίντεο |
| ΔιαμόρφωσηUltra | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταΖητούμενες ρυθμίσεις· μόνο εκτίμηση. | Δημιουργία ήχουΜε ήχο | Ανάλυση720p | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο εξόδου | Συνθήκες χρέωσης— | Χρέωση Έξοδος · Εκτιμώμενο δευτερόλεπτο βίντεο εξόδου · Εκτίμηση μόνο για σύγκριση $0.2 ανά δευτερόλεπτο βίντεο εξόδου Η εμφανιζόμενη χρέωση εκτιμά το κόστος πριν από τη δημιουργία. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική δημιουργία. Η φυσική διάρκεια του βίντεο δεν είναι η χρεώσιμη ποσότητα. |
| ΔιαμόρφωσηΤιμή βίντεο | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Δημιουργία ήχου— | Ανάλυση— | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο | Συνθήκες χρέωσηςήχος: without_audio | Χρέωση Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $0.2 ανά δευτερόλεπτο βίντεο |
| ΔιαμόρφωσηΤιμή βίντεο | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Δημιουργία ήχου— | Ανάλυση— | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο | Συνθήκες χρέωσηςήχος: without_audio; ανάλυση: 4k | Χρέωση Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $0.5 ανά δευτερόλεπτο βίντεο |
| ΔιαμόρφωσηUltra | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταΖητούμενες ρυθμίσεις· μόνο εκτίμηση. | Δημιουργία ήχουΧωρίς ήχο | Ανάλυση720p | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο εξόδου | Συνθήκες χρέωσης— | Χρέωση Έξοδος · Εκτιμώμενο δευτερόλεπτο βίντεο εξόδου · Εκτίμηση μόνο για σύγκριση $0.16 ανά δευτερόλεπτο βίντεο εξόδου Η εμφανιζόμενη τιμή εκτιμά το κόστος πριν από τη δημιουργία. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική δημιουργία. Η πραγματική διάρκεια βίντεο δεν αποτελεί τη χρεώσιμη ποσότητα. |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Δημιουργία ήχου— | Ανάλυση— | Μονάδα τιμολόγησης— | Συνθήκες χρέωσης— | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.64 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Στοιχεία τιμοκαταλόγου αναφοράς
Οι πίνακες αναφοράς του μοντέλου δεν αλλάζουν την επιλογή μεθόδου, τις εκτιμήσεις τιμής ή τις χρεώσεις. Οι εφαρμοζόμενες χρεώσεις χρησιμοποιούν τις τιμές της επιλεγμένης μεθόδου Ailoot.
Τιμές αναφοράς για διαμορφώσεις βίντεο
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςήχος: with_audio | Χρέωση Έξοδος · Τιμή βίντεο $0.24 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςήχος: with_audio; ανάλυση: 4k | Χρέωση Έξοδος · Τιμή βίντεο $0.6 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςήχος: without_audio | Χρέωση Έξοδος · Τιμή βίντεο $0.2 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςήχος: with_audio; ανάλυση: 720p | Χρέωση Έξοδος · Τιμή βίντεο $0.2 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςήχος: without_audio; ανάλυση: 4k | Χρέωση Έξοδος · Τιμή βίντεο $0.5 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςήχος: without_audio; ανάλυση: 720p | Χρέωση Έξοδος · Τιμή βίντεο $0.16 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
Παραδείγματα αιτημάτων
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-fast", "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-fast
Εναλλακτικές διαδρομές μεθόδων
/v1/videos/generations, /videos, /videos/generations
Σχετικά ID μοντέλων
FAQ · Google: Veo 3.1 Fast
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/videos·google/veo-3.1-fast:text→video- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/videos·google/veo-3.1-fast:model,prompt,duration,resolution,aspect_ratio,generate_audio