ByteDance: Seedance 2.5

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

Ailoot Ultra · Βίντεο POST /v1/videos doubao-seedance-2-5-260628

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

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

Το Seedance 2.5 δημιουργεί βίντεο χρησιμοποιώντας γραπτή σκηνή και πολυτροπικές αναφορές. Το συγκεκριμένο αναγνωριστικό επιλογής doubao-seedance-2-5-260628 έχει τη δική του τεκμηριωμένη λειτουργία και παράδειγμα. Αυτή η λειτουργία περιγράφει δημιουργία, επεξεργασία και επέκταση βίντεο, με εικόνες, βίντεο, ήχο και κείμενο ως μέσα εισόδου. Χρησιμοποίησε τις αναφορές για να μεταδώσεις την εμφάνιση του θέματος, τη δράση, την κίνηση της κάμερας, το ύφος και τον ήχο και μετά εξήγησε το αποτέλεσμα που θέλεις να δημιουργήσεις από αυτές.

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

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

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

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

Το τεκμηριωμένο πολυτροπικό παράδειγμα του 2.5 θέτει generate_audio=true και ζητά ακολουθία δεκαπέντε δευτερολέπτων με κάδρο 16:9. Αυτές οι τιμές περιγράφουν το συγκεκριμένο παράδειγμα, όχι καθολικό ανώτατο όριο διάρκειας ή όριο αρχείων αναφοράς. Δώσε στη ζητούμενη σκηνή σαφή ηχητική κατεύθυνση, μαζί με τη σχέση μουσικής, εφέ και ορατής δράσης, και μετά αξιολόγησε την πραγματική οπτικοακουστική έξοδο. Η ηχητική αναφορά και η παραγόμενη ηχητική επένδυση πρέπει να ελεγχθούν μαζί ως προς τον επιθυμητό ρυθμό και την ερμηνεία.

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

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

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

Ailoot Ultra · Βίντεο POST /v1/videos doubao-seedance-2-5-260628

doubao-seedance-2-5-260628

ByteDance /doubao-seedance-2-5-260628

Εισαγωγή

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

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

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

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

Πεδίο	Τύπος	Απαίτηση	Τιμές και όρια	Προεπιλογή
Πεδίο`model`	Τύπος`string`	ΑπαίτησηΥποχρεωτικό	Τιμές και όρια doubao-seedance-2-5-260628	Προεπιλογή—
Πεδίο`content`	Τύπος`array`	ΑπαίτησηΥποχρεωτικό	Τιμές και όρια Συνθήκες: Εγγενή αντικείμενα κειμένου και πολυμέσων· ο εξωτερικός πίνακας δεν πρέπει να είναι κενός. Οι τύποι εμφωλευμένων κόμβων δεν επικυρώνονται από αυτόν τον γενικό κατασκευαστή του Ailoot.	Προεπιλογή—
Πεδίο`generate_audio`	Τύπος`boolean`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια Συνθήκες: Το παράδειγμα για την 2.5 ορίζει true, αλλά η αντιγραμμένη περιγραφή επιλογέα αναφέρει μόνο 2.0/fast/1.5· δεν παρέχεται ευρύτερη εγγύηση για ρυθμίσεις ή προεπιλογές.	Προεπιλογή—
Πεδίο`duration`	Τύπος`integer`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια Συνθήκες: Η κυριολεκτική τιμή 15 στο παράδειγμα για την 2.5 δεν είναι μέγιστο ή προεπιλογή.	Προεπιλογή—
Πεδίο`resolution`	Τύπος`string`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια Συνθήκες: Δεν συνάγεται προεπιλογή ή απαρίθμηση τιμών ειδική για την 2.5 από αντιγραμμένες περιγραφές.	Προεπιλογή—
Πεδίο`ratio`	Τύπος`string`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια Συνθήκες: Το adaptive αφορά ρητά τα 2.0/fast/1.5· το παράδειγμα για το 2.5 δείχνει μόνο 16:9.	Προεπιλογή—
Πεδίο`watermark`	Τύπος`boolean`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια	Προεπιλογήfalse
Πεδίο`seed`	Τύπος`integer`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια Ελάχιστο: -1 Μέγιστο: 4.294.967.295	Προεπιλογή-1
Πεδίο`execution_expires_after`	Τύπος`integer`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια Ελάχιστο: 3.600 Μέγιστο: 259.200 Μονάδα: δευτερόλεπτα	Προεπιλογή172.800
Πεδίο`service_tier`	Τύπος`string`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια Συνθήκες: Τα 2.0/fast αποκλείουν το flex εκτός σύνδεσης· το πεδίο εφαρμογής για το 2.5 δεν έχει καθοριστεί.	Προεπιλογή—
Πεδίο`safety_identifier`	Τύπος`string`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια	Προεπιλογή—

Συνδυασμοί υλικών εισόδου

Παράμετροι και κύκλος ζωής μεθόδου

Παράμετρος	Σύμβαση
Παράμετρος`content_type`	Σύμβασηapplication/json
Παράμετρος`required`	Σύμβασηcontent, model
Παράμετρος`optional`	Σύμβασηgenerate_audio, duration, resolution, ratio, watermark, seed, execution_expires_after, service_tier, safety_identifier
Παράμετρος`material_types`	Σύμβασηtext, image, video, audio
Παράμετρος`additional_properties`	Σύμβασηtrue
Παράμετρος`validation_scope`	ΣύμβασηΤο Ailoot ελέγχει τους τύπους των απαιτούμενων πεδίων και ότι το model και ο πίνακας content δεν είναι κενά. Τα υπόλοιπα πεδία αιτήματος διατηρούνται για το επιλεγμένο μοντέλο.
Παράμετρος`material_combinations`	Σύμβασηtext, image, video, image, audio, image, video, video, audio, image, video, audio
Παράμετρος`optional_text_with_media`	Σύμβασηtrue
Παράμετρος`reference_media_count_and_size_limits`	Σύμβαση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
ΔιαμόρφωσηΗ είσοδος περιέχει βίντεο αναφοράς.	Πίνακας χρεώσεων—	Προβλεπόμενη ποσότητα—	Μονάδα τιμολόγησηςανά 1K token βίντεο	Χρέωση Έξοδος · Εκτίμηση μόνο για σύγκριση $0.012 ανά 1K token βίντεο
ΔιαμόρφωσηΗ είσοδος δεν περιέχει βίντεο αναφοράς.	Πίνακας χρεώσεων—	Προβλεπόμενη ποσότητα—	Μονάδα τιμολόγησηςανά 1K token βίντεο	Χρέωση Έξοδος · Εκτίμηση μόνο για σύγκριση $0.02 ανά 1K token βίντεο
ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας	Πίνακας χρεώσεων—	Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία	Μονάδα τιμολόγησης—	Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.822402 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή.

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

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

Ailoot Ultra · Βίντεο

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

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"doubao-seedance-2-5-260628","content":[{"type":"text","text":"女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动"}]}
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-2-5-260628

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

/v1/videos/generations

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

doubao-seedance-2-5-260628

FAQ · ByteDance: Seedance 2.5

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

ByteDance: Seedance 2.5