μοντέλα

HeyGen: HeyGen Video

Markdown · JSON

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 /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 · Βίντεο

curl · δημιουργήστε βίντεο
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
Έλεγχος κατάστασης εργασίας
Λήψη της κατάστασης της αρχικής ενέργειας με GET
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 μοντέλων

heygen/heygen-video-1

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

Περισσότερες λεπτομέρειες

Συνδέστε το Ailoot με Claude Code, OpenCode, Hermes ή τη δική σας εφαρμογή.

Η εταιρεία και το χαρτοφυλάκιο έργων της

Η εταιρεία και το χαρτοφυλάκιο έργων της: εκατομμύρια πελάτες· μηνιαίες πωλήσεις δισεκατομμυρίων.

Αγοράστε token με έκπτωση.

Έκπτωση συνδρομής για τακτική χρήση. Προωθητικοί κωδικοί — έως 50% στην αγορά token.

Συνδρομή
Επιλέξτε πρόγραμμα με έκπτωση για τα τακτικά αιτήματά σας.
Προωθητικός κωδικός έως 50%
Εισαγάγετε τον κωδικό στην αγορά. Η τιμή επανυπολογίζεται σύμφωνα με την ενεργή προσφορά.
Δαπάνες στο ιστορικό
Μοντέλο, token και ποσό αποθηκεύονται για κάθε αίτημα.

Επιλέξτε συνδρομή · Δείτε τιμές μοντέλων

Συνδέστε το API με το προϊόν που πουλάτε.

SaaS, εφαρμογές και bot — σύμφωνα με τη δημόσια προσφορά και τη σύμβαση άδειας χρήσης Ailoot. Για μεταπώληση ζητήστε σχετική άδεια.

Εμπορική εφαρμογή
Ενσωματώστε δημιουργία κειμένου, εικόνων, βίντεο και ήχου στις πληρωμένες λειτουργίες της υπηρεσίας σας.
Άδεια για μεταπωλητή
Στείλτε περιγραφή έργου και τρόπο πρόσβασης. Ζητήστε γραπτούς όρους χρήσης και μεταπώλησης.
Έγγραφα στον ιστότοπο
Δημόσια προσφορά, σύμβαση άδειας χρήσης και πολιτική επεξεργασίας δεδομένων είναι διαθέσιμες πριν τη σύνδεση.

Ζητήστε άδεια μεταπώλησης · Δημόσια προσφορά και σύμβαση άδειας χρήσης