ByteDance: Seedance 1.0 Pro Fast
Το Seedance 1.0 Pro Fast είναι το ξεχωριστά ονομαζόμενο προφίλ Fast για δημιουργία βίντεο χωρίς ήχο από κείμενο και εικόνα. Δέχεται οδηγίες σκηνής ή σύνθεση που καθοδηγείται από εικόνα, με έξοδο 2–12 δευτερολέπτων, 24 fps και ρητούς ελέγχους κάδρου.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Seedance 1.0 Pro Fast είναι το προφίλ Fast με αναγνωριστικό doubao-seedance-1-0-pro-fast-251015. Δημιουργεί βίντεο χωρίς ήχο από γραπτή σκηνή ή από αρχική σύνθεση που καθοδηγείται από εικόνα. Το συγκεκριμένο αναγνωριστικό επιλογής διακρίνει αυτό το προφίλ από το Seedance 1.0 Pro· η λέξη Fast δεν ορίζει εγγυημένο χρόνο ολοκλήρωσης για μια μεμονωμένη εργασία. Διάλεξε τρόπο εισόδου ανάλογα με το τι πρέπει να καθορίσει τη σκηνή και, στη συνέχεια, αξιολόγησε το επιστρεφόμενο απόσπασμα σύμφωνα με αυτές τις οδηγίες.
Ένα πλάνο που καθοδηγείται από κείμενο ξεκινά με μια σύντομη ακολουθία: το θέμα και το περιβάλλον, τη δράση, τη διαδρομή της κάμερας και την τελική όψη. Για μια σταδιακή παρουσίαση προϊόντος, περιέγραψε το αντικείμενο πάνω σε μια επιφάνεια, το φως πάνω στο υλικό του και μια σύντομη κίνηση που καταλήγει στο χαρακτηριστικό που παρουσιάζεται. Για μια ιδέα τοποθεσίας, πέρασε από ένα ευρύ γενικό πλάνο σε ένα αναγνωρίσιμο σημείο ενδιαφέροντος. Απόφυγε να ζητάς από ένα σύντομο απόσπασμα να εκτελέσει πολλές άσχετες σκηνές, των οποίων τα θέματα και τα περιβάλλοντα πρέπει όλα να παρουσιαστούν από την αρχή.
Ένα πλάνο που καθοδηγείται από εικόνα ξεκινά με στοιχείο image_url στον πίνακα content και με γραπτή οδηγία κίνησης. Προετοίμασε την περικοπή, το φόντο και τη διάταξη του θέματος στην εικόνα και μετά δήλωσε ποια στοιχεία κινούνται και πώς συμπεριφέρεται η κάμερα. Έτσι μια στατική σύνθεση μπορεί να γίνει σύντομη σκηνή με κίνηση. Αυτό χρησιμεύει για ένα πορτρέτο, ένα αντικείμενο πάνω σε τραπέζι ή μια προετοιμασμένη οπτική ιδέα, ενώ το πραγματικό αποτέλεσμα εξακολουθεί να χρειάζεται έλεγχο ταυτότητας, σχήματος και κίνησης σε όλο το απόσπασμα.
Οι είσοδοι εικόνας μπορούν να χρησιμοποιούν προσβάσιμο URL ή URL δεδομένων Base64. Οι τεκμηριωμένες μορφές είναι JPEG, PNG, WEBP, BMP, TIFF και GIF· η εικόνα πρέπει να είναι μικρότερη από 30 MB, με τις δύο διαστάσεις αυστηρά μεταξύ 300 και 6000 εικονοστοιχείων και το πλάτος διαιρεμένο με το ύψος αυστηρά μεταξύ 0.4 και 2.5. Διάλεξε καθαρή αρχική εικόνα με ορατές λεπτομέρειες του θέματος. Ο οδηγός εικόνων συνιστά κάδρο adaptive (προσαρμοστικό), οπότε οι αναλογίες της προετοιμασμένης εικόνας πρέπει να ταιριάζουν με τη σύνθεση στην οποία θέλεις να δώσεις κίνηση.
Η τεκμηρίωση του προφίλ 1.0 αναφέρει διάρκεια δύο έως δώδεκα δευτερολέπτων στα 24 fps. Το Pro Fast έχει προεπιλεγμένη ανάλυση 1080p και ο διατηρημένος πίνακας εξόδου περιλαμβάνει επίπεδα 480p, 720p και 1080p. Ο οδηγός της λειτουργίας αποκλείει το 1080p στην περίπτωση εικόνας αναφοράς. Οι σταθερές αναλογίες διαστάσεων περιλαμβάνουν 16:9, 4:3, 1:1, 3:4, 9:16 και 21:9. Διάλεξε ανάλυση και αναλογία κατάλληλες για τον επιλεγμένο τρόπο εισόδου, αντί να υποθέτεις ότι κάθε συνδυασμός είναι εναλλάξιμος.
Οι επιλογές seed και watermark βοηθούν να παραμένουν ρητές οι ρυθμίσεις του αιτήματος. Το εύρος του ακέραιου seed είναι από -1 έως 2^32-1· το -1 ζητά τυχαία τιμή. Η οδηγία σταθερής κάμερας εφαρμόζεται υπό προϋποθέσεις: ο οδηγός την αποκλείει στην περίπτωση εικόνας αναφοράς και δεν εγγυάται το οπτικό αποτέλεσμα όπου υποστηρίζεται. Οι εντολές παραμέτρων που ενσωματώνονται στο κείμενο υπερισχύουν των ξεχωριστών προαιρετικών παραμέτρων. Κράτησε αυτές τις οδηγίες συνεπείς, ιδίως όταν αναθεωρείς κείμενο του οποίου μια παλιά εντολή διάρκειας ή ανάλυσης θα μπορούσε διαφορετικά να παραμείνει στην περιγραφή της σκηνής.
Η χρήση μετριέται σε token βίντεο: πλάτος εξόδου × ύψος εξόδου × ρυθμός καρέ × διάρκεια εξόδου / 1024. Η ολοκληρωμένη εργασία αναφέρει αυτή την ποσότητα ως usage.completion_tokens. Κράτησε την αναφερόμενη χρήση μαζί με το ολοκληρωμένο απόσπασμα και τις ζητούμενες ρυθμίσεις του.
Η υποβολή δημιουργεί ασύγχρονη εργασία. Αποθήκευσε το αναγνωριστικό της, παρακολούθησε την κατάστασή της και ανάκτησε το ολοκληρωμένο βίντεο από το content.video_url μετά την επιτυχία. Η τεκμηρίωση αναφέρει ότι τα παραγόμενα αρχεία διατηρούνται για επτά ημέρες, οπότε κράτησε το ολοκληρωμένο αρχείο μαζί με τις οδηγίες και οποιαδήποτε εικόνα εισόδου. Έλεγξε ολόκληρη τη δράση, την κίνηση της κάμερας και το τελικό κάδρο· αν μια λεπτομέρεια δεν ανταποκρίνεται στις οδηγίες, περιέγραψε τη συγκεκριμένη διόρθωση διατηρώντας τα μέρη που πέτυχαν.
Ailoot Ultra · Βίντεο POST /v1/videos doubao-seedance-1-0-pro-fast-251015
doubao-seedance-1-0-pro-fast-251015
doubao-seedance-1-0-pro-fast-251015Εισαγωγή
Το Seedance 1.0 Pro Fast είναι το ξεχωριστά ονομαζόμενο προφίλ Fast για δημιουργία βίντεο χωρίς ήχο από κείμενο και εικόνα. Δέχεται οδηγίες σκηνής ή σύνθεση που καθοδηγείται από εικόνα, με έξοδο 2–12 δευτερολέπτων, 24 fps και ρητούς ελέγχους κάδρου.
- Αποδεκτές είσοδοι
- Κείμενο · Εικόνες
- Αποτελέσματα
- Βίντεο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Βίντεο POST /v1/videos
- Είσοδος
text,image- Έξοδος
video
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια doubao-seedance-1-0-pro-fast-251015 | Προεπιλογή— |
Πεδίοcontent | Τύποςarray | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Συνθήκες: Εγγενή αντικείμενα κειμένου και πολυμέσων· ο εξωτερικός πίνακας δεν πρέπει να είναι κενός. Οι τύποι εμφωλευμένων κόμβων δεν επικυρώνονται από αυτόν τον γενικό κατασκευαστή του Ailoot. | Προεπιλογή— |
Πεδίοduration | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 2 Μέγιστο: 12 Συνθήκες: Το αρχικό σχήμα 1.x ορίζει 2–12· μεταγενέστερη κοινή περιγραφή ορίζει την 1.5 ως 4–12 ή -1. Το παράδειγμα χρησιμοποιεί την κοινά τεκμηριωμένη τιμή 5. | Προεπιλογή5 |
Πεδίοresolution | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Οι επιβεβαιωμένες τιμές για κείμενο σε βίντεο είναι 480p και 1080p. Η είσοδος εικόνας αναφοράς αποκλείει το 1080p. Η κοινή απαρίθμηση τιμών 720p συγκρούεται με την περιγραφή του συγκεκριμένου μοντέλου, επομένως η υποστήριξη 720p παραμένει αδιευκρίνιστη και στις δύο λειτουργίες. | Προεπιλογή1080p |
Πεδίοratio | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Συνθήκες: Προεπιλογές που εξαρτώνται από τη σκηνή και το μοντέλο· η τεκμηρίωση εισόδου εικόνας συνιστά adaptive. | Προεπιλογή— |
Πεδίοservice_tier | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια default, flex Συνθήκες: default=online, flex=offline· επιλέξτε πριν από τη δημιουργία. | Προεπιλογήdefault |
Πεδίοseed | Τύποςinteger | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο: -1 Μέγιστο: 4.294.967.295 | Προεπιλογή-1 |
Πεδίοcamerafixed | Τύποςboolean | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Συνθήκες: Απαιτείται από το Ailoot· ο έλεγχος κάμερας με εικόνα αναφοράς τεκμηριώνεται ως μη υποστηριζόμενος και η επίδρασή του δεν είναι εγγυημένη. | Προεπιλογήfalse |
Πεδίοwatermark | Τύποςboolean | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογήfalse |
Πεδίοexecution_expires_after | Τύποςinteger | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο: 3.600 Μέγιστο: 259.200 Μονάδα: δευτερόλεπτα | Προεπιλογή172.800 |
Συνδυασμοί υλικών εισόδου
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηcamerafixed, content, execution_expires_after, model, seed, watermark |
Παράμετροςoptional | Σύμβασηduration, resolution, ratio, service_tier |
Παράμετροςmaterial_types | Σύμβασηtext, image |
Παράμετροςadditional_properties | Σύμβασηtrue |
Παράμετροςvalidation_scope | ΣύμβασηΤο Ailoot ελέγχει τους τύπους των απαιτούμενων πεδίων και ότι το model και ο πίνακας content δεν είναι κενά. Τα υπόλοιπα πεδία αιτήματος διατηρούνται για το επιλεγμένο μοντέλο. |
Παράμετροςimage_constraints | Σύμβαση{"formats":["jpeg","png","webp","bmp","tiff","gif"],"aspect_ratio_exclusive":[0.4,2.5],"dimensions_px_exclusive":[300,6000],"file_size_mb_exclusive":30,"mb_bytes_definition":null} |
Εναλλακτικά ονόματα μεθόδου: /v1/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/polling_url που επιστρέφεται.
Ελέγχετε περιοδικά την αρχική εργασία· κατεβάστε το πραγματικό content.video_url που σας ανήκει μετά το succeeded.
Τιμολόγηση
Πώς υπολογίζεται η τελική χρέωση
Οι εμφανιζόμενες τιμές χρησιμοποιούνται για την εκτίμηση του κόστους πριν από την παραγωγή. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική παραγωγή. Η μετρημένη διάρκεια της εξόδου και οι προβλεπόμενες ποσότητες δεν αποτελούν την τελική χρεώσιμη ποσότητα.
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Εκτιμώμενες χρεώσεις για σύγκριση
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Προβλεπόμενη ποσότητα | Μονάδα τιμολόγησης | Χρέωση |
|---|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις token | Πίνακας χρεώσεωνΒασική χρέωση | Προβλεπόμενη ποσότητα— | Μονάδα τιμολόγησης— | Χρέωση Είσοδος · Token εισόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Έξοδος · Token εξόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα · Εκτίμηση μόνο για σύγκριση — / 1K token |
| ΔιαμόρφωσηUltra | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Μονάδα τιμολόγησηςανά 1K token βίντεο | Χρέωση Έξοδος · Εκτίμηση μόνο για σύγκριση $0.0012 ανά 1K token βίντεο |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Μονάδα τιμολόγησης— | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.0576 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Βίντεο
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-0-pro-fast-251015","content":[{"type":"text","text":"女孩抱着狐狸,女孩睁开眼,温柔地看向镜头,狐狸友善地抱着,镜头缓缓拉出,女孩的头发被风吹动"}],"resolution":"480p","ratio":"1:1","duration":5,"service_tier":"default","seed":-1,"camerafixed":false,"watermark":false,"execution_expires_after":172800}
JSON_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
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i.startswith("native302_"):raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
set -eu
python3 - <<'PY_ASSETS'
import json
from pathlib import Path
from urllib.parse import urlsplit
r=json.loads(Path("status.json").read_text())
if r.get("status")!="succeeded":raise SystemExit("Poll same original job until an owned result is returned.")
u=r.get("content",{}).get("video_url")
urls=[u] if isinstance(u,str) else u
if not isinstance(urls,list) or not urls:raise SystemExit("No completed video URL.")
for u in urls:
if not isinstance(u,str):raise SystemExit("Invalid returned URL.")
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/media/assets/") or not p.path.endswith("/content") or not p.query:raise SystemExit("Wait for actual Ailoot-owned signed result.")
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_ASSETS
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" -o "video-${index}.bin"
index=$((index + 1))
done < asset-urls.txt
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · Βίντεο
Εγγενές JSON με δημόσιο id/polling_url. Μετά τη δημοσίευση, το content.video_url περιέχει υπογεγραμμένα URL που ανήκουν στο Ailoot· πριν από τη δημοσίευση, τα επιλεγμένα URL εξόδου είναι κενά.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Αποθηκεύστε κάθε ολοκληρωμένο βίντεο ή αρχείο που επιστρέφεται· ανακτήστε κάθε πραγματικό URL αρχείου που επιστρέφεται.
Διατηρήστε κάθε πραγματικό URL στο content.video_url· το index πρέπει να προσδιορίζει πραγματική έξοδο που επιστράφηκε.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διατηρήστε την αρχική απόκριση, τις κεφαλίδες και το id, και ελέγχετε περιοδικά αυτή τη λειτουργία· μην επανυποβάλετε ποτέ αίτημα δημιουργίας με άγνωστο αποτέλεσμα.
Πεδία απάντησης
| Πεδίο | Τύπος |
|---|---|
Πεδίοid | Τύποςstring |
Πεδίοprovider_task_id | Τύποςstring |
Πεδίοpolling_url | Τύποςstring |
Πεδίοstatus | Τύποςstring when supplied |
Πεδίοcontent.video_url | Τύποςstring|string[] |
Πεδίοusage | Τύποςobject when supplied |
Σφάλματα και επόμενα βήματα
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΜη έγκυρο JSON, μοντέλο, τύποι απαιτούμενων πεδίων ή δείκτης περιεχομένου. | Επόμενο βήμα |
Απάντηση401 · authentication_error | ΣυνθήκηΜη έγκυρο κλειδί API του Ailoot. | Επόμενο βήμα |
Απάντηση404 · not_found_error | ΣυνθήκηΗ εργασία ή έξοδος απουσιάζει ή δεν ανήκει στον ίδιο χρήστη, κλειδί API ή ομάδα. | Επόμενο βήμα |
Απάντηση502 · result_pending_check | ΣυνθήκηΗ αρχική υποβολή ή κατάστασή της είναι ελλιπής· διατηρήστε το αρχικό ID, χωρίς επανυποβολή. | Επόμενο βήμα |
Απάντηση503 · result_pending_check | ΣυνθήκηΤα αρχικά πολυμέσα, η διαδρομή ή η εκκαθάριση ελέγχονται· συνεχίστε την αρχική λειτουργία. | Επόμενο βήμα |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra doubao-seedance-1-0-pro-fast-251015
Εναλλακτικές διαδρομές μεθόδων
/v1/videos/generations
Σχετικά ID μοντέλων
FAQ · ByteDance: Seedance 1.0 Pro Fast
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:text,image→video- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after- Ποια όρια ισχύουν;
POST /v1/videos·doubao-seedance-1-0-pro-fast-251015:duration.minimum:2;duration.maximum:12;seed.minimum:-1;seed.maximum:4294967295;execution_expires_after.minimum:3600;execution_expires_after.maximum:259200