ByteDance: Seedance 1.0 Pro

Το Seedance 1.0 Pro δημιουργεί βίντεο χωρίς ήχο από κείμενο ή αρχική εικόνα. Περιέγραψε τη δράση και την κάμερα ή δώσε κίνηση σε μια υπάρχουσα σύνθεση, με διάρκεια 2–12 δευτερόλεπτα, 24 fps και ρητούς ελέγχους για το κάδρο και την ανάλυση εξόδου.

Ailoot Ultra · Βίντεο POST /v1/videos doubao-seedance-1-0-pro-250528

Σχετικά με το μοντέλο

Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.

Το Seedance 1.0 Pro δημιουργεί βίντεο από κείμενο ή από μια σκηνή που καθοδηγείται από εικόνα. Το αναγνωριστικό επιλογής doubao-seedance-1-0-pro-250528 υποστηρίζει και τους δύο τρόπους εισόδου, οπότε η αφετηρία μπορεί να είναι μια γραπτή ιδέα ή μια υπάρχουσα οπτική σύνθεση. Χρησιμοποίησε γραπτές οδηγίες για να δημιουργήσεις μια νέα σκηνή ή δώσε εικόνα όταν το θέμα, η διάταξη και η αρχική όψη πρέπει να καθοριστούν οπτικά. Αυτό το προφίλ 1.0 παράγει βίντεο χωρίς ήχο· ο συγχρονισμένος ήχος ανήκει στο ξεχωριστά περιγραφόμενο προφίλ 1.5 Pro.

Για δημιουργία βίντεο από κείμενο, προσδιόρισε το θέμα, το περιβάλλον, την κίνηση, το κάδρο και την κάμερα σε μία συνεκτική σκηνή. Το τεκμηριωμένο παράδειγμα μετακινείται σταδιακά από ένα χωράφι με μαργαρίτες σε κοντινή όψη ενός λουλουδιού με δροσιά στα πέταλα. Αυτή η δομή χρησιμεύει και σε άλλες σταδιακές παρουσιάσεις: δείξε το περιβάλλον, πλησίασε το θέμα και ολοκλήρωσε στη σημαντική λεπτομέρεια. Για μια ιδέα προϊόντος, περιέγραψε το υλικό και τον φωτισμό μαζί με τη δράση και δώσε στην κάμερα μια εφικτή διαδρομή στο σύντομο πλάνο.

Για δημιουργία βίντεο από εικόνα, τοποθέτησε την αναφορά σε ένα στοιχείο image_url του content και εξήγησε τι πρέπει να αλλάξει από αυτή την αρχική όψη. Ένα προετοιμασμένο πορτρέτο μπορεί να καθορίσει το πρόσωπο και την περικοπή, ενώ οι οδηγίες περιγράφουν μια μικρή στροφή, κίνηση των μαλλιών ή απαλή απομάκρυνση της κάμερας. Μια στατική εικόνα προϊόντος μπορεί να καθορίσει το αντικείμενο και το φόντο, ενώ οι οδηγίες ζητούν μια ελεγχόμενη παρουσίαση. Κράτησε τη ζητούμενη κίνηση συμβατή με την αρχική σύνθεση· μια εικόνα της μίας πλευράς ενός αντικειμένου δεν παρέχει ακριβή όψη κάθε άλλης πλευράς που δεν φαίνεται.

Το πεδίο εικόνας δέχεται προσβάσιμο URL ή URL δεδομένων που περιέχει δεδομένα εικόνας Base64. Οι τεκμηριωμένες μορφές είναι JPEG, PNG, WEBP, BMP, TIFF και GIF. Οι εικόνες πρέπει να είναι μικρότερες από 30 MB, με λόγο πλάτους προς ύψος αυστηρά μεταξύ 0.4 και 2.5 και κάθε διάσταση αυστηρά μεταξύ 300 και 6000 εικονοστοιχείων. Προετοίμασε μια καθαρή αρχική εικόνα με την επιθυμητή περικοπή, αντί να βασίζεσαι σε μικρογραφία από την οποία λείπουν ήδη οι χαρακτηριστικές λεπτομέρειες. Για δημιουργία βίντεο από εικόνα, ο οδηγός συνιστά κάδρο adaptive (προσαρμοστικό) που ακολουθεί τις αναλογίες της αναφοράς.

Η τεκμηριωμένη διάρκεια του 1.0 είναι δύο έως δώδεκα δευτερόλεπτα και ο ρυθμός καρέ είναι 24 fps. Οι έλεγχοι εξόδου περιλαμβάνουν επίπεδα 480p, 720p και 1080p, με προεπιλογή το 1080p για το Pro· ο οδηγός αποκλείει το 1080p στην περίπτωση εικόνας αναφοράς. Οι σταθερές αναλογίες περιλαμβάνουν 16:9, 4:3, 1:1, 3:4, 9:16 και 21:9. Διάλεξε συνδυασμό συμβατό με εικόνες για ένα πλάνο που καθοδηγείται από εικόνα, αντί να μεταφέρεις αμετάβλητες όλες τις ρυθμίσεις δημιουργίας από κείμενο. Εξέτασε το πραγματικό κάδρο που επιστρέφεται πριν εντάξεις το απόσπασμα σε μια διάταξη.

Οι έλεγχοι seed και watermark τεκμηριώνονται μαζί με το camerafixed. Η οδηγία σταθερής κάμερας δεν υποστηρίζεται στην περίπτωση εικόνας αναφοράς και, όπου εφαρμόζεται, ο οδηγός δεν εγγυάται απόλυτα ακίνητη κάμερα. Οι οδηγίες παραμέτρων που ενσωματώνονται στο κείμενο έχουν προτεραιότητα έναντι των ξεχωριστών προαιρετικών πεδίων. Κράτησε μία έγκυρη ρύθμιση για τη διάρκεια, την ανάλυση και την αναλογία και κάνε την περιγραφή της κάμερας να συμφωνεί με αυτή. Έτσι αποφεύγεις την αθόρυβη παράκαμψη των επιλεγμένων ρυθμίσεων του αιτήματος από τις οδηγίες της σκηνής.

Η χρήση μετριέται σε token βίντεο: πλάτος εξόδου × ύψος εξόδου × ρυθμός καρέ × διάρκεια εξόδου / 1024. Η ολοκληρωμένη εργασία αναφέρει αυτή την ποσότητα ως usage.completion_tokens. Κράτησε την αναφερόμενη χρήση μαζί με το ολοκληρωμένο απόσπασμα και τις ζητούμενες ρυθμίσεις του.

Η ροή εργασίας επιστρέφει πρώτα αναγνωριστικό εργασίας και, μετά την επεξεργασία, τη θέση του ολοκληρωμένου βίντεο. Διατήρησε το αναγνωριστικό όσο ελέγχεις αν η εργασία βρίσκεται σε κατάσταση queued ή running· μια εργασία succeeded παρέχει το content.video_url και πληροφορίες χρήσης. Η τεκμηριωμένη περίοδος διατήρησης των παραγόμενων αρχείων είναι επτά ημέρες. Αποθήκευσε το ολοκληρωμένο απόσπασμα, την αρχική εικόνα και τις ακριβείς οδηγίες ως αρχείο αναθεώρησης και, στη συνέχεια, εξέτασε την εμφάνιση του θέματος, την κίνηση, την οπτική συνέχεια και την τελική σύνθεση σε όλο το αποτέλεσμα.

Ailoot Ultra · Βίντεο POST /v1/videos doubao-seedance-1-0-pro-250528

doubao-seedance-1-0-pro-250528

ByteDance /doubao-seedance-1-0-pro-250528

Εισαγωγή

Αποδεκτές είσοδοι: Κείμενο · Εικόνες
Αποτελέσματα: Βίντεο

Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι

Ailoot Ultra · Βίντεο POST /v1/videos

Είσοδος: text, image
Έξοδος: video

Πεδίο	Τύπος	Απαίτηση	Τιμές και όρια	Προεπιλογή
Πεδίο`model`	Τύπος`string`	ΑπαίτησηΥποχρεωτικό	Τιμές και όρια doubao-seedance-1-0-pro-250528	Προεπιλογή—
Πεδίο`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.0044 ανά 1K token βίντεο
ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας	Πίνακας χρεώσεων—	Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία	Μονάδα τιμολόγησης—	Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.2112 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή.

Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →

Παραδείγματα αιτημάτων

Ailoot Ultra · Βίντεο

curl · δημιουργήστε βίντεοcurl · διαβάστε την αρχική εργασίαcurl · κατεβάστε το βίντεο που σας ανήκει

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-1-0-pro-250528","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}/content
GET /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-250528

Εναλλακτικές διαδρομές μεθόδων

/v1/videos/generations

Σχετικά ID μοντέλων

doubao-seedance-1-0-pro-250528

FAQ · ByteDance: Seedance 1.0 Pro

Ποιες είσοδοι και αποτελέσματα διατίθενται;: POST /v1/videos · doubao-seedance-1-0-pro-250528: text, image → video
Ποια πεδία χρησιμοποιεί το αίτημα;: POST /v1/videos · doubao-seedance-1-0-pro-250528: model, content, duration, resolution, ratio, service_tier, seed, camerafixed, watermark, execution_expires_after
Ποια όρια ισχύουν;: POST /v1/videos · doubao-seedance-1-0-pro-250528: duration.minimum: 2; duration.maximum: 12; seed.minimum: -1; seed.maximum: 4294967295; execution_expires_after.minimum: 3600; execution_expires_after.maximum: 259200

ByteDance: Seedance 1.0 Pro