HeyGen: HeyGen Video
Το HeyGen Video παράγει σκηνές 5–15 δευτερολέπτων με διάλογο, ήχους περιβάλλοντος και εφέ από κείμενο, πρώτη εικόνα ή οπτικές και ηχητικές αναφορές. Το μοντέλο γενικής χρήσης heygen-video-1 υποστηρίζει πλάνα προϊόντων και χαρακτήρων, με χειριστήρια αναφορών και έξοδο MP4. Οι σαφείς, περιορισμένες δράσεις του δίνουν χρήσιμη οδηγία παραγωγής.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το HeyGen Video είναι το μοντέλο γενικής χρήσης της HeyGen για παραγωγή σκηνών, το οποίο ο κατασκευαστής προσδιορίζει ως heygen-video-1. Δημιουργεί μαζί θέμα, σκηνικό, φως και ήχο από δημιουργική οδηγία. Κάθε απόσπασμα διαρκεί 5–15 δευτερόλεπτα και περιέχει το παραγόμενο ηχητικό κομμάτι του, συμπεριλαμβανομένων διαλόγου, ήχων περιβάλλοντος και εφέ. Χρήσιμες είσοδοι παραγωγής περιλαμβάνουν περιγραφή σκηνής, φωτογραφία προϊόντος ή υλικό που ορίζει άτομο, χώρο ή κίνηση. Το τελικό στοιχείο είναι σύντομη σκηνή για παρουσίαση προϊόντος, ένθετο εισαγωγικής καθοδήγησης, άποψη ακινήτου ή άλλη εργασία μοντάζ βίντεο.
Τρεις λειτουργίες δίνουν διαφορετικούς ρόλους στις εισόδους. Η μετατροπή κειμένου σε βίντεο δημιουργεί σκηνή από την προτροπή. Η μετατροπή εικόνας σε βίντεο ξεκινά κυριολεκτικά από την παρεχόμενη εικόνα και έπειτα ακολουθεί την οδηγία για τη δράση. Η μετατροπή αναφορών σε βίντεο χρησιμοποιεί παρεχόμενες εικόνες, βίντεο και προαιρετικό ήχο για να καθοδηγήσει νέα σύνθεση σκηνής· απαιτεί τουλάχιστον μία εικόνα ή βίντεο αναφοράς. Επιλέξτε εικόνα πρώτου καρέ όταν η αρχική σύνθεση πρέπει να ταιριάζει σε στατική εικόνα ή αναφορές όταν γνωστό αντικείμενο πρέπει να εμφανιστεί σε διαφορετική σύνθεση. Αυτό το μοντέλο σκηνών διαφέρει από τις μηχανές απόδοσης avatar και τη ροή σύνθεσης Video Agent της HeyGen.
Ο οδηγός του κατασκευαστή προτιμά λεπτομερείς, συγκεκριμένες οδηγίες πλάνων: ένα θέμα, μία τοποθεσία και μία περιορισμένη δράση, με σταθερή ή ήπια κινούμενη κάμερα. Περιγράψτε θέση κάμερας, φακό ή επιδίωξη βάθους πεδίου, φως, υφή επιφανειών και χρωματική απόδοση. Εξηγήστε πού ακουμπούν τα αντικείμενα όταν μια ενέργεια εξαρτάται από επαφή. Για πρωτότυπο παράδειγμα προϊόντος, χρησιμοποιήστε φωτογραφία αναφοράς θερμός ταξιδιού και ζητήστε να στέκεται σε ξύλινο πάγκο ενώ παρουσιαστής μιλά δίπλα του, με μικρή κίνηση κάμερας προς το θερμός. Επιθεωρήστε τη μορφή, την τοποθέτηση και τις ορατές σημάνσεις του θερμός στο αποτέλεσμα.
Οι λίστες αναφορών υποστηρίζουν έως εννέα εικόνες, τρία βίντεο και τρία στοιχεία ήχου, με μέγιστο δώδεκα αναφορές συνολικά. Εικόνες, βίντεο και ήχος αριθμούνται ξεχωριστά στη μορφή προτροπής του κατασκευαστή: η πρώτη εικόνα είναι <Picture 1> και το πρώτο βίντεο <Video 1>. Δώστε σε κάθε αναφορά ρόλο και προσδιορίστε τον ρητά στην οδηγία. Το μοντέλο διαβάζει τα πρώτα πέντε δευτερόλεπτα κάθε βίντεο αναφοράς, επομένως προετοιμάστε τη σχετική ενότητα στην αρχή. Η αναφορά API ορίζει επίσης αναλογίες βίντεο αναφοράς μεταξύ 1:4 και 4:1. Ένα μεγάλο απόσπασμα που περιέχει την επιθυμητή κίνηση μόνο στο τέλος του είναι ακατάλληλη προετοιμασία για αυτό το παράθυρο εισόδου πέντε δευτερολέπτων.
Η τεκμηριωμένη διεπαφή αναφορών δέχεται απευθείας προσβάσιμο πόρο HTTPS, αναγνωριστικό μεταφορτωμένου στοιχείου ή ενσωματωμένο base64. Ο οδηγός παραθέτει μέγιστα μεγέθη εικόνων 16 MB μέσω URL και 5 MB ενσωματωμένα· το βίντεο ή ο ήχος μπορεί να είναι έως 32 MB μέσω URL και 16 MB ενσωματωμένα. Προετοιμάστε ευανάγνωστο αρχικό υλικό με εύκολα διακριτό το σημαντικό θέμα και χωρίς ανταγωνιστικές οδηγίες σε διαφορετικές αναφορές. Διατηρήστε τον επιδιωκόμενο προσανατολισμό στην εικόνα πρώτου καρέ. Αυτές οι λεπτομέρειες εισόδου αφορούν τη ροή αναφορών του κατασκευαστή και βοηθούν στην οργάνωση δημιουργικών υλικών για την επιλεγμένη λειτουργία.
Κατευθύνετε τον ήχο στην ίδια οδηγία με την εικόνα. Δηλώστε διάλογο, φωνητική εκφορά, ήχο δωματίου και συγκεκριμένα εφέ, συμπεριλαμβανομένου του αν ένας ήχος πρέπει να είναι κοντινός ή μακρινός. Προσδιορίστε τη μουσική απόδοση όταν η σκηνή πρέπει να περιέχει μόνο ομιλία και ήχους περιβάλλοντος. Ο οδηγός προτείνει περίπου 2,5 εκφωνούμενες λέξεις ανά δευτερόλεπτο ως εκτίμηση σχεδιασμού, επομένως αφήστε χώρο για παύσεις και ορατή δράση. Μια σύντομη εισαγωγή μπορεί να σχεδιαστεί ως μία ατάκα ακολουθούμενη από στιγμή που αποκαλύπτει το προϊόν. Ακούστε τις πραγματικές λέξεις και αν ο παραγόμενος ήχος ταιριάζει στον χώρο και στη δράση.
Η διάρκεια εξόδου επιλέγεται σε ακέραια δευτερόλεπτα από πέντε έως δεκαπέντε, με προεπιλογή πέντε δευτερολέπτων. Η ανάλυση είναι κατηγορία μεγέθους: 480p, 768p, 1080p ή 2k. Οι τεκμηριωμένες επιλογές κάδρου είναι 21:9, 16:9, 4:3, 1:1, 3:4 και 9:16. Για μετατροπή κειμένου και αναφορών σε βίντεο στα 1080p ή 2k, επιλέξτε 16:9 ή 9:16· προσαρμοστικό καδράρισμα αναφορών τεκμηριώνεται στα 480p και 768p. Η μετατροπή εικόνας σε βίντεο ακολουθεί τις αναλογίες της πρώτης εικόνας, επομένως περικόψτε πριν από την παραγωγή όταν αλλάζει το απαιτούμενο σχήμα. Ελέγξτε τις πραγματικές διαστάσεις του ολοκληρωμένου αποτελέσματος αντί να υποθέτετε ότι μια ετικέτα κατηγορίας μεγέθους συνεπάγεται ένα συμβατικό ζεύγος pixel.
Ο οδηγός μοντέλου ορίζει βίντεο MP4 με κωδικοποίηση εικόνας H.264 και ήχο AAC στα 32 kHz στερεοφωνικά. Η παραγωγή επεξεργάζεται ασύγχρονα και η ολοκληρωμένη εργασία παρέχει τη θέση αναπαραγώγιμου βίντεο, τη διάρκεια και τις διαστάσεις. Η υπογεγραμμένη θέση βίντεο μπορεί να ανανεώνεται με νέα ανάκτηση της εργασίας. Διατηρήστε το πραγματικό απόσπασμα, τα υλικά αναφοράς και την οδηγία για έλεγχο μοντάζ. Μια εγγραφή εκκρεμότητας ή επεξεργασίας παρακολουθεί την παραγωγή· το ολοκληρωμένο βίντεο είναι το τεχνούργημα παραγωγής προς αξιολόγηση για εικόνα, ομιλία και ήχο.
Ο κατασκευαστής τεκμηριώνει επιλογές ενίσχυσης προτροπής turbo, quality και disabled· το disabled διατηρεί την έτοιμη διατύπωση όπως γράφτηκε. Ένα σταθερό seed είναι χρήσιμο όταν συγκρίνετε αλλαγή μίας πρότασης διατηρώντας τις υπόλοιπες εισόδους. Καταγράψτε το επιλεγμένο seed και τις ρυθμίσεις μαζί με την οδηγία πλάνου. Για γράμματα στην οθόνη, κρατήστε μια επιδιωκόμενη φράση σύντομη και γράψτε τη με ακρίβεια· ο οδηγός συνιστά μεταγενέστερη σύνθεση παραγράφων, κειμένου μικρού μεγέθους και διαγραμμάτων με ετικέτες. Ελέγξτε κάθε ορατό χαρακτήρα ενός παραγόμενου τίτλου αντί να υποθέτετε ότι η διατύπωση αναπαράχθηκε σωστά.
Ο οδηγός προσδιορίζει το εκτενές κείμενο στην οθόνη, την απαλή οργανική κίνηση όπως πέταλα, χαρτί ή μαλλιά και τον κοντινό χειρισμό με χέρια ως λιγότερο αξιόπιστους τομείς. Για διαδικαστική εξήγηση, αφήστε μια σαφώς γραμμένη ατάκα να μεταφέρει τα βήματα ενώ η εικόνα δείχνει σταθερό άτομο ή αντικείμενο· χρησιμοποιήστε ξεχωριστά επαληθευμένο οπτικό υλικό όταν η ίδια η φυσική λειτουργία πρέπει να είναι ακριβής. Ελέγξτε ολόκληρο το πλάνο για συνέχεια αντικειμένων, επαφή, λεπτομέρειες προσώπου και χεριών, διάλογο και ήχο. Μια σύντομη λίστα όσων πρέπει να αλλάξουν στην επόμενη λήψη διατηρεί πρακτική μια λεπτομερή οδηγία παραγωγής.
Ailoot Ultra · Βίντεο POST /v1/videos heygen/heygen-video-1
heygen/heygen-video-1Εισαγωγή
Το HeyGen Video παράγει σκηνές 5–15 δευτερολέπτων με διάλογο, ήχους περιβάλλοντος και εφέ από κείμενο, πρώτη εικόνα ή οπτικές και ηχητικές αναφορές. Το μοντέλο γενικής χρήσης heygen-video-1 υποστηρίζει πλάνα προϊόντων και χαρακτήρων, με χειριστήρια αναφορών και έξοδο MP4. Οι σαφείς, περιορισμένες δράσεις του δίνουν χρήσιμη οδηγία παραγωγής.
- Αποδεκτές είσοδοι
- Κείμενο · Εικόνες · Ήχος · Βίντεο
- Αποτελέσματα
- Βίντεο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Βίντεο POST /v1/videos
- Είσοδος
text,image,audio,video- Έξοδος
video- Μορφή εξόδου
- αρχικά byte του MP4· χωρίς κανονικοποίηση ή διακωδικοποίηση
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια heygen/heygen-video-1 | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοduration | Τύποςinteger | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Ελάχιστο: 1 Μέγιστο: 600 | Προεπιλογή— |
Πεδίοresolution | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 480p, 768p, 2K | Προεπιλογή— |
Πεδίοaspect_ratio | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Προεπιλογή— |
Πεδίοgenerate_audio | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια false | Προεπιλογή— |
Πεδίοframe_images | Τύποςarray | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο πλήθος στοιχείων: 1 Μέγιστο πλήθος στοιχείων: 1 Περιεχόμενο εισόδου: Πίνακας αντικειμένων καρέ. Κάθε αντικείμενο έχει type=image_url, image_url που περιέχει url και frame_type. Χρησιμοποιήστε HTTPS URL εικόνας και ορίστε το frame_type σε first_frame. Κάθε ρόλος καρέ εμφανίζεται το πολύ μία φορά. Ακριβή κλειδιά: type, image_url, frame_type Συνθήκες: Αυτά τα κλειδιά περιγράφουν κάθε αντικείμενο καρέ· το image_url περιέχει μόνο url. Παραλείψτε το frame_images για αίτημα μόνο με κείμενο. | Προεπιλογή— |
Πεδίοinput_references | Τύποςarray | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοseed | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: -9.223.372.036.854.775.808 Μέγιστο: 9.223.372.036.854.775.807 | Προεπιλογή— |
Πεδίοcallback_url | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Μοτίβο: ^https:// | Προεπιλογή— |
Πεδίοsession_id | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοtrace | Τύποςobject | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοuser | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Συνδυασμοί υλικών εισόδου
Κείμενο σε βίντεο · Μια γραπτή προτροπή. · Υποχρεωτικό: model, prompt, duration
Δώστε την προτροπή ως κείμενο και τη διάρκεια σε ακέραια δευτερόλεπτα. Επιλέξτε υποστηριζόμενη ανάλυση και, αν χρειάζεται, αναλογία διαστάσεων.
model: Τύπος: string · heygen/heygen-video-1
prompt: Τύπος: string · Μέγιστο πλήθος byte UTF-8: 10.000 · Απαιτείται περιεχόμενο πέρα από κενά διαστήματα: Ναι
Εικόνα σε βίντεο · Μια γραπτή προτροπή και μια εικόνα πρώτου καρέ. · Υποχρεωτικό: model, prompt, duration, frame_images
Το frame_images είναι πίνακας. Κάθε αντικείμενο καρέ έχει type, image_url και frame_type· το image_url περιέχει url. Ορίστε το type σε image_url. Χρησιμοποιήστε first_frame. Κάθε ρόλος καρέ εμφανίζεται το πολύ μία φορά. Δώστε ένα δημόσιο HTTPS URL εικόνας για κάθε καρέ. Επιλέξτε υποστηριζόμενη ανάλυση και, αν χρειάζεται, αναλογία διαστάσεων.
Ακριβή κλειδιά: type, image_url, frame_type
model: Τύπος: string · heygen/heygen-video-1
prompt: Τύπος: string · Μέγιστο πλήθος byte UTF-8: 10.000 · Απαιτείται περιεχόμενο πέρα από κενά διαστήματα: Ναι
Reference to video · Μια γραπτή προτροπή και υποστηριζόμενες αναφορές εικόνας, βίντεο και ήχου. · Υποχρεωτικό: model, prompt, duration, input_references
Το input_references είναι πίνακας αντικειμένων. Ορίστε το type σε image_url, video_url, audio_url και χρησιμοποιήστε το αντίστοιχο πεδίο που περιέχει url. Χρησιμοποιήστε δημόσια HTTPS URL. Παραλείψτε το frame_images για να επιλέξετε λειτουργία αναφορών. Επιλέξτε υποστηριζόμενη ανάλυση και, αν χρειάζεται, αναλογία διαστάσεων.
model: Τύπος: string · heygen/heygen-video-1
prompt: Τύπος: string · Μέγιστο πλήθος byte UTF-8: 10.000 · Απαιτείται περιεχόμενο πέρα από κενά διαστήματα: Ναι
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, prompt, duration |
Παράμετροςmaterial_types | Σύμβασηtext, image, audio, video |
Παράμετροςadditional_properties | Σύμβασηfalse |
Παράμετροςoptional_controls | Σύμβασηresolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user |
Κύκλος ζωής: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Τιμολόγηση
Πώς υπολογίζεται η τελική χρέωση
Οι εμφανιζόμενες τιμές χρησιμοποιούνται για την εκτίμηση του κόστους πριν από την παραγωγή. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική παραγωγή. Η μετρημένη διάρκεια της εξόδου και οι προβλεπόμενες ποσότητες δεν αποτελούν την τελική χρεώσιμη ποσότητα.
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Εκτιμώμενες χρεώσεις για σύγκριση
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Προβλεπόμενη ποσότητα | Μονάδα τιμολόγησης | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις token | Πίνακας χρεώσεωνΒασική χρέωση | Προβλεπόμενη ποσότητα— | Μονάδα τιμολόγησης— | Συνθήκες χρέωσης— | Χρέωση Είσοδος · Token εισόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Έξοδος · Token εξόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα · Εκτίμηση μόνο για σύγκριση — / 1K token |
| ΔιαμόρφωσηΤιμή βίντεο | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο | Συνθήκες χρέωσηςresolution: 2k | Χρέωση Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $0.2 ανά δευτερόλεπτο βίντεο |
| ΔιαμόρφωσηΤιμή βίντεο | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο | Συνθήκες χρέωσηςresolution: 480p | Χρέωση Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $0.04 ανά δευτερόλεπτο βίντεο |
| ΔιαμόρφωσηΤιμή βίντεο | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο | Συνθήκες χρέωσηςresolution: 768p | Χρέωση Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $0.072 ανά δευτερόλεπτο βίντεο |
| ΔιαμόρφωσηΤιμή βίντεο | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο | Συνθήκες χρέωσηςλειτουργία δημιουργίας: reference; ανάλυση: 2k | Χρέωση Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $0.36 ανά δευτερόλεπτο βίντεο |
| ΔιαμόρφωσηΤιμή βίντεο | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο | Συνθήκες χρέωσηςλειτουργία δημιουργίας: reference; ανάλυση: 480p | Χρέωση Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $0.14 ανά δευτερόλεπτο βίντεο |
| ΔιαμόρφωσηΤιμή βίντεο | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο | Συνθήκες χρέωσηςλειτουργία δημιουργίας: reference; ανάλυση: 768p | Χρέωση Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $0.2 ανά δευτερόλεπτο βίντεο |
| Διαμόρφωσηεικόνα αναφοράς εισόδου | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Μονάδα τιμολόγησηςανά εικόνα αναφοράς εισόδου | Συνθήκες χρέωσης— | Χρέωση Είσοδος · εικόνα αναφοράς εισόδου · Εκτίμηση μόνο για σύγκριση $0.08 ανά εικόνα αναφοράς εισόδου |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Μονάδα τιμολόγησης— | Συνθήκες χρέωσης— | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.2 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Στοιχεία τιμοκαταλόγου αναφοράς
Οι πίνακες αναφοράς του μοντέλου δεν αλλάζουν την επιλογή μεθόδου, τις εκτιμήσεις τιμής ή τις χρεώσεις. Οι εφαρμοζόμενες χρεώσεις χρησιμοποιούν τις τιμές της επιλεγμένης μεθόδου Ailoot.
Τιμές αναφοράς για διαμορφώσεις βίντεο
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςresolution: 2k | Χρέωση Έξοδος · Τιμή βίντεο $0.18 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςresolution: 480p | Χρέωση Έξοδος · Τιμή βίντεο $0.04 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςresolution: 768p | Χρέωση Έξοδος · Τιμή βίντεο $0.06 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςλειτουργία δημιουργίας: reference; ανάλυση: 2k | Χρέωση Έξοδος · Τιμή βίντεο $0.36 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςλειτουργία δημιουργίας: reference; ανάλυση: 480p | Χρέωση Έξοδος · Τιμή βίντεο $0.08 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςλειτουργία δημιουργίας: reference; ανάλυση: 768p | Χρέωση Έξοδος · Τιμή βίντεο $0.12 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
Παραδείγματα αιτημάτων
Ailoot Ultra · Βίντεο
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"heygen/heygen-video-1","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', encoding='utf-8')
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 · Βίντεο
υπογεγραμμένα URL περιεχομένου που σας ανήκει
GET /v1/videos/{public_id}GET /v1/videos/{public_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 αρχείου που επιστρέφεται.
Διατηρήστε κάθε πραγματική έξοδο που σας ανήκει και τα μετρημένα μεταδεδομένα που επιστρέφονται μαζί της.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
503 result_pending_check + αρχικό id + X-Should-Retry:false· μην επαναλάβετε ποτέ το αρχικό αίτημα
Πεδία απάντησης
| Πεδίο | Τύπος | Σημασία |
|---|---|---|
Πεδίοindex | Τύποςinteger | ΣημασίαΘέση αυτού του βίντεο στη λίστα εξόδων, με αρίθμηση από το μηδέν. |
Πεδίοcontent_url | Τύποςstring | ΣημασίαΥπογεγραμμένο HTTPS URL λήψης για αυτό το ολοκληρωμένο βίντεο. |
Πεδίοsha256 | Τύποςstring | null | ΣημασίαΣύνοψη SHA-256 των αρχικών byte βίντεο· null αν δεν είναι διαθέσιμη. |
Πεδίοsize_bytes | Τύποςinteger | null | ΣημασίαΜέγεθος του αρχικού αρχείου βίντεο σε byte· null αν δεν είναι διαθέσιμο. |
Πεδίοduration_ms | Τύποςinteger | null | ΣημασίαΜετρημένη διάρκεια βίντεο σε χιλιοστά του δευτερολέπτου· null αν δεν είναι διαθέσιμη. |
Πεδίοwidth | Τύποςinteger | null | ΣημασίαΠλάτος βίντεο σε pixel· null αν δεν είναι διαθέσιμο. |
Πεδίοheight | Τύποςinteger | null | ΣημασίαΎψος βίντεο σε pixel· null αν δεν είναι διαθέσιμο. |
Πεδίοvideo_codec | Τύποςstring | null | ΣημασίαΑναγνωριστικό κωδικοποιητή βίντεο· null αν δεν έχει καταγραφεί. |
Πεδίοhas_audio | Τύποςboolean | null | ΣημασίαΑν το βίντεο περιέχει ηχητικό κομμάτι· null αν δεν έχει μετρηθεί. |
Πεδίοaudio_codec | Τύποςstring | null | ΣημασίαΑναγνωριστικό κωδικοποιητή ήχου· null όταν δεν έχει καταγραφεί αναγνωριστικό. |
Σφάλματα και επόμενα βήματα
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση404 · not_found_error | ΣυνθήκηΗ πρόσβαση στο βίντεο δεν είναι διαθέσιμη ή αυτό το ID βίντεο δεν βρέθηκε. | Επόμενο βήμαΕλέγξτε την πρόσβαση στο βίντεο. Για υπάρχον βίντεο, χρησιμοποιήστε το αρχικό δημόσιο ID του και το ίδιο κλειδί API. |
Απάντηση401 · authentication_error | ΣυνθήκηΤο κλειδί API δεν αντιστοιχεί στον ταυτοποιημένο λογαριασμό. | Επόμενο βήμαΕλέγξτε το κλειδί API και την πρόσβαση του λογαριασμού σας πριν υποβάλετε αίτημα. |
Απάντηση400 · invalid_request_error | ΣυνθήκηΔεν ήταν δυνατή η ανάγνωση του αιτήματος ή ο δείκτης λήψης δεν είναι έγκυρος. | Επόμενο βήμαΔιορθώστε το σώμα αιτήματος. Για λήψη, επιλέξτε δείκτη εξόδου που επιστράφηκε από την αρχική εργασία. |
Απάντηση422 · price_unavailable | ΣυνθήκηΗ επιλεγμένη διαμόρφωση βίντεο δεν μπορεί να τιμολογηθεί. | Επόμενο βήμαΕπιλέξτε μια υποστηριζόμενη διαμόρφωση βίντεο και συμπληρώστε τις απαιτούμενες επιλογές της πριν υποβάλετε διορθωμένο αίτημα. |
Απάντηση422 · invalid_request_error | ΣυνθήκηΜια είσοδος βίντεο ή η αρχική εργασία συνέχισης δεν είναι έγκυρη. | Επόμενο βήμαΧρησιμοποιήστε έγκυρες εισόδους HTTPS. Για συνέχιση, χρησιμοποιήστε το δημόσιο ID του ολοκληρωμένου αρχικού σας βίντεο με το ίδιο κλειδί API. |
Απάντηση402 · billing_error | ΣυνθήκηΤο διαθέσιμο υπόλοιπο ή τα όρια δεν επιτρέπουν δέσμευση ποσού. | Επόμενο βήμαΕλέγξτε το διαθέσιμο υπόλοιπο και τα όριά σας πριν στείλετε νέο αίτημα. |
Απάντηση503 · server_error | ΣυνθήκηΗ επαλήθευση βίντεο, η αποθήκευση ή η πρόσβαση στην υπηρεσία είναι προσωρινά μη διαθέσιμη. | Επόμενο βήμαΠεριμένετε να γίνει διαθέσιμη η υπηρεσία. Αν έχετε ήδη ID βίντεο, ελέγξτε αυτή την αρχική εργασία αντί να ξεκινήσετε άλλη δημιουργία. |
Απάντηση503 · result_pending_check | ΣυνθήκηΤο αρχικό αποτέλεσμα βίντεο και η χρέωση χρειάζονται έλεγχο. | Επόμενο βήμαΔιατηρήστε το ID βίντεο που επιστρέφεται και ελέγξτε αυτή την εργασία. Μην στέλνετε νέο αίτημα δημιουργίας για αντικατάσταση όσο διαρκεί ο έλεγχος. |
Απάντηση503 · owned_result_unavailable | ΣυνθήκηΗ λήψη του υπάρχοντος βίντεο είναι προσωρινά μη διαθέσιμη. | Επόμενο βήμαΕλέγξτε αργότερα την ίδια εργασία βίντεο και κατεβάστε την υπάρχουσα έξοδό της. Μια νέα δημιουργία παράγει ξεχωριστή λειτουργία. |
Απάντηση409 · video_not_ready | ΣυνθήκηΤο περιεχόμενο βίντεο δεν έχει δημοσιευτεί. | Επόμενο βήμαΕλέγξτε την κατάσταση της αρχικής εργασίας. Κατεβάστε το αποτέλεσμα όταν αναφέρει completed· αν αναφέρει failed, ακολουθήστε την ειδοποίησή της για έλεγχο χρέωσης. |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra heygen/heygen-video-1
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
FAQ · HeyGen: HeyGen Video
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/videos·heygen/heygen-video-1:text,image,audio,video→video- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/videos·heygen/heygen-video-1:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,seed,callback_url,session_id,trace,user- Ποια όρια ισχύουν;
POST /v1/videos·heygen/heygen-video-1:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807