Έγγραφα προγραμματιστή UlazAI
Τεκμηρίωση Seedance API: δημιουργία, κατάσταση, 1080p και τιμολόγηση
Αναφορά Seedance 1.5 Pro
Έγγραφα Seedance API Τεκμηρίωση Seedance API: δημιουργία, κατάσταση, 1080p και τιμολόγηση
Για να χρησιμοποιήσετε το Seedance API, έλεγχος ταυτότητας με κλειδί φορέα, χρησιμοποιήστε
POST /seedance/generate/ δημιουργία θέσεων εργασίας και δημοσκόπηση
GET /seedance/status/{generation_id}/ μέχρι να είναι έτοιμο το βίντεο.
Το UlazAI υποστηρίζει αυτήν τη στιγμή την έξοδο Seedance 1.5 Pro σε 480p, 720p και 1080p με διάρκεια 4, 8 ή 12 δευτερολέπτων.
Βασικά τελικά σημεία
POST /seedance/upload/
POST /seedance/generate/
GET /seedance/status/{generation_id}/
Τρέχουσες δυνατότητες
Κείμενο σε βίντεο και εικόνα σε βίντεο
Έως 2 εικόνες οδηγών
Προαιρετικός εγγενής ήχος
Συμβουλή
Αυτή η σελίδα απαντά στην πλήρη ροή προγραμματιστών στην πρώτη οθόνη: το τελικό σημείο δημιουργίας, η δημοσκόπηση κατάστασης, η υποστήριξη 1080p, η ταυτότητα του φορέα και η διαδρομή τιμολόγησης.
Χρήση/seedance/upload/ μόνο όταν χρειάζεστε δημιουργία βίντεο με καθοδήγηση εικόνας. Για εκτελέσεις μόνο κειμένου, καλέστε
/seedance/generate/ απευθείας και παραλείψτε το βήμα μεταφόρτωσης.
Η οικογένεια μοντέλων Seedance: 1.5 Pro, 2.0 και 2.5
Το Seedance είναι το μοντέλο κειμένου σε βίντεο και εικόνας σε βίντεο της ByteDance. Η ByteDance κυκλοφόρησε το πρώτο Seedance τον Ιούνιο του 2025, απελευθερώθηκε Seedance 2.0 τον Φεβρουάριο του 2026 και έκτοτε έχει δείξει Seedance 2.5. Κάθε ένα Η γενιά προωθεί περαιτέρω την ίδια βασική ιδέα: κινηματογραφική κίνηση, ισχυρότερη παρακολούθηση prompt, σκηνές πολλαπλών λήψεων, αναφορές εικόνας και βίντεο και προαιρετικός εγγενής ήχος σε μία μόνο απόδοση. Ο οδηγός API καλύπτει την τρέχουσα υποστήριξη Εκδόσεις Seedance χωρίς να απαιτείται να ρυθμίσετε τη δική σας πλατφόρμα του ByteDance.
| Έκδοση | Κυκλοφορεί από την ByteDance | Τι προσθέτει |
|---|---|---|
Seedance 1.5 Pro | 2025 | Κείμενο και εικόνα σε βίντεο, έως 2 εικόνες οδηγών, προαιρετικός ήχος, 480p/720p/1080p. Συνδέθηκε σήμερα στο UlazAI. |
Seedance 2.0 | Φεβρουάριος 2026 | Πολυτροπικές εισροές (κείμενο, εικόνα, βίντεο, ήχος), αφήγηση ιστοριών με πολλές κάμερες, εγγενής συμπαραγωγή ήχου, μεγαλύτερα κλιπ. |
Seedance 2.5 | 2026 | Το νεότερο βήμα που έχει δείξει η ByteDance, με στόχο την ταχύτερη παραγωγή και περαιτέρω κέρδη ποιότητας και ελέγχου. |
Ίδιος κωδικός, νεότερο μοντέλο
Το δημόσιο API του UlazAI δημιουργεί με bytedance/seedance-1.5-pro σήμερα. Το σημαντικό μέρος για τους προγραμματιστές:
όταν μια νεότερη έκδοση Seedance είναι ενεργοποιημένη εδώ, επαναχρησιμοποιεί το ίδια Κομιστής auth και η ίδια
δημιουργία και δημοσκόπηση τελικών σημείων παρακάτω. Η ενσωμάτωσή σας δεν αλλάζει — αλλά μόνο το αναγνωριστικό μοντέλου — το ίδιο
μπορείτε να στηρίξετε αυτήν την αναφορά τώρα και να ανεβείτε την οικογένεια αργότερα.
ByteDance και ARK: το επίσημο μοντέλο, μια ενοποιημένη διαδρομή
Άνθρωποι που ψάχνουν Επίσημη τεκμηρίωση ByteDance Seedance ή το Κιβωτός Seedance API συνήθως αναζητούν δύο διαφορετικά πράγματα: το ίδιο το μοντέλο και έναν τρόπο να το αποκαλέσουν πραγματικά. Το Seedance είναι του ByteDance δικό του μοντέλο, που δημοσιεύτηκε μέσω του Volcano Engine της ByteDance ΚΙΒΩΤΟΣ πλατφόρμα. Αυτή η διαδρομή σημαίνει τη δημιουργία ΚΙΒΩΤΟΣ λογαριασμός, πρόσβασης περιοχής και τελικών σημείων ακατέργαστων μοντέλων.
Το UlazAI βρίσκεται μπροστά από αυτό ως επίπεδο API τρίτου κατασκευαστή. Παίρνετε ένα κλειδί φορέα, μια φιλοξενούμενη
μεταφόρτωση εικόνας βήμα, ένα κοινόχρηστο πορτοφόλι πίστωσης και το μικρό σύνολο τελικών σημείων σε αυτήν τη σελίδα — χωρίς ARK
ενσωμάτωση, καμία περιφερειακή λύση και κανένας αριθμός VPN ή κινεζικού τηλεφώνου για πρόσβαση στο μοντέλο. Αν έψαξες συγκεκριμένα
Μεταφόρτωση εικόνας ARK API Seedance, το αντίστοιχο εδώ είναι μια μεμονωμένη κλήση: POST /seedance/upload/
επιστρέφει μια μόνιμη διεύθυνση URL στην οποία εισάγετε input_urls κατά τη δημιουργία (δείτε το τελικό σημείο μεταφόρτωσης παρακάτω).
Οι έννοιες του ARK αντιστοιχίζονται σε αυτό το API
Εάν έχετε ήδη διαβάσει την τεκμηρίωση ARK του ByteDance, το λεξιλόγιο είναι διαφορετικό αλλά το τα βήματα είναι τα ίδια. Αυτή είναι η απευθείας μετάφραση:
| Στο ByteDance ARK | Εδώ | Τι αλλάζει για σένα |
|---|---|---|
| Ρύθμιση λογαριασμού ARK, έργου και τελικού σημείου | Ένα κλειδί φέροντος | Δεν υπάρχει σύνδεση σε πλατφόρμα πριν από την πρώτη κλήση. |
| Φιλοξενήστε την εικόνα του οδηγού μόνοι σας, περάστε μια δημόσια διεύθυνση URL | POST /seedance/upload/ |
Μπορείτε να στείλετε το ακατέργαστο αρχείο. η απάντηση σάς δίνει μια μόνιμη διεύθυνση URL. |
| Αναγνωριστικό μοντέλου στο σώμα του αιτήματος | model πεδίο |
Ίδια ιδέα? μόνο το αναγνωριστικό αλλάζει μεταξύ των εκδόσεων. |
| Δημοσκοπήστε την εργασία μέχρι να ολοκληρωθεί | GET /seedance/status/{generation_id}/ |
Ίδιο σχήμα δημοσκόπησης, ένα τελικό σημείο. |
Από εικόνα σε βίντεο σε δύο κλήσεις
Αυτή είναι ολόκληρη η ροή μεταφόρτωσης εικόνων. Η πρώτη κλήση αποθηκεύει την εικόνα και επιστρέφει μια διεύθυνση URL, η δεύτερη κλήση χρησιμοποιεί αυτή τη διεύθυνση URL ως οπτική καθοδήγηση για το βίντεο.
# 1. upload the guide image
curl -X POST https://ulazai.com/seedance/upload/ \
-H "Authorization: Bearer $ULAZAI_API_KEY" \
-F "[email protected]"
# -> {"url": "https://cdn.ulazai.com/uploads/<id>.jpg"}
# 2. generate, passing that URL back in input_urls
curl -X POST https://ulazai.com/seedance/generate/ \
-H "Authorization: Bearer $ULAZAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "slow dolly in, warm evening light",
"input_urls": ["https://cdn.ulazai.com/uploads/<id>.jpg"],
"resolution": "1080p"
}'
Μπορείτε να μεταβιβάσετε έως και δύο διευθύνσεις URL input_urls. Δύο εικόνες διαβάζονται ως αρχή και
αναφορά τέλους, που είναι ο συνηθισμένος τρόπος για να διατηρήσετε έναν χαρακτήρα ή ένα προϊόν συνεπή σε όλα τα
κλιπ. Για δημιουργία μόνο κειμένου, παραλείψτε εντελώς την κλήση μεταφόρτωσης.
Σύνοψη γρήγορης ενοποίησης
| Auth | Κλειδί φορέα API από /dashboard/ -> Πλήκτρα API |
|---|---|
| Αναγνωριστικό μοντέλου | bytedance/seedance-1.5-pro |
| Διάρκεια | 4s, 8s, 12s |
| Ψηφίσματα | 480p, 720p, 1080p |
| Αναλογίες διαστάσεων | 1:1, 21:9, 4:3, 3:4, 16:9, 9:16 |
| Εισροές | Prompt μόνο ή prompt συν έως 2 διευθύνσεις URL εικόνας |
| Εκλογική ροή | Δημιουργήστε μια δουλειά, αποθηκεύστε generation_id, στη συνέχεια κατάσταση δημοσκόπησης μέχρι completed |
Δημόσια σύνοψη τελικού σημείου
| Μέθοδος | Τελικό σημείο | Πότε να το χρησιμοποιήσετε |
|---|---|---|
| ΑΝΑΡΤΗΣΗ | /seedance/upload/ |
Ανεβάστε πρώτα μια εικόνα εάν θέλετε καθοδήγηση από εικόνα σε βίντεο |
| ΑΝΑΡΤΗΣΗ | /seedance/generate/ |
Δημιουργήστε μια εργασία δημιουργίας Seedance 1.5 Pro |
| ΠΑΡΕ | /seedance/status/{generation_id}/ |
Ελέγξτε εάν η εργασία εξακολουθεί να υποβάλλεται σε επεξεργασία, ολοκληρώθηκε ή απέτυχε |
Έλεγχος ταυτότητας
Όλα τα αιτήματα API απαιτούν διακριτικό φορέα:
Authorization: Bearer YOUR_API_KEY
Αποκτήστε ένα κλειδί API από τον πίνακα ελέγχου σας κάτω Πλήκτρα API. Εάν εξακολουθείτε να χρειάζεστε πιστώσεις, μεταβείτε στο πακέτα πρώτον.
/seedance/upload/
Ανεβάστε εικόνες εισόδου για καθοδήγηση εικόνας σε βίντεο
Ανεβάστε μια εικόνα οδηγού πριν από τη δημιουργία, εάν θέλετε το Seedance να αγκυροβολήσει τη σύνθεση, το καδράρισμα χαρακτήρων ή τη ρύθμιση σκηνής.
Η απάντηση σάς δίνει μια μόνιμη διεύθυνση URL για μεταβίβαση input_urls.
Κεφαλίδες αιτήματος
Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data
Παράμετροι δεδομένων φόρμας
αρχείο * (αρχείο)
JPG, PNG ή WebP, έως 10 MB.
Απόκριση επιτυχίας (200)
{
"success": true,
"url": "https://media.ulazai.com/seedance_images/u1_abc123.jpg",
"filename": "seedance_images/u1_abc123.jpg"
}
Παράδειγμα χρήσης (cURL)
curl -X POST https://api.ulazai.com/seedance/upload/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@/path/to/image.jpg"
/seedance/generate/
Δημιουργήστε μια εργασία δημιουργίας Seedance 1.5 Pro
Στείλτε είτε το απλοποιημένο ωφέλιμο φορτίο παρακάτω είτε το ρητό model συν input μορφή.
Χρησιμοποιήστε την απλοποιημένη έκδοση εάν χρειάζεστε μόνο τη δημόσια διαδρομή Seedance με prompt, προαιρετικές εικόνες οδηγών και ρυθμίσεις εξόδου.
Σώμα αιτήματος (απλό)
{
"prompt": "A cinematic close-up of a chef flipping noodles in slow motion",
"input_urls": ["https://media.ulazai.com/seedance_images/u1_abc123.jpg"],
"aspect_ratio": "16:9",
"resolution": "1080p",
"duration": "4",
"fixed_lens": true,
"generate_audio": false,
"prompt_directory_optin": true
}
Σώμα αιτήματος (μοντέλο/στυλ εισαγωγής)
{
"model": "bytedance/seedance-1.5-pro",
"input": {
"prompt": "A cinematic close-up of a chef flipping noodles in slow motion",
"input_urls": ["https://media.ulazai.com/seedance_images/u1_abc123.jpg"],
"aspect_ratio": "16:9",
"resolution": "720p",
"duration": "8",
"fixed_lens": true,
"generate_audio": true
}
}
Παράμετροι
prompt * (χορδή)
3 έως 2500 χαρακτήρες που περιγράφουν τη σκηνή, την κίνηση, το καδράρισμα και την ηχητική πρόθεση.
input_urls (πίνακας)
Προαιρετικό. Έως 2 διευθύνσεις URL εικόνας για καθοδήγηση εικόνας σε βίντεο.
aspect_ratio (χορδή)
Ένα από τα: 1:1, 21:9, 4:3, 3:4, 16:9, 9:16.
ανάλυση (χορδή)
Ένα από τα: 480p, 720p, 1080p.
διάρκεια (χορδή)
4, 8 ή 12 δευτερόλεπτα.
fixed_lens (Boolean)
Ενεργοποιήστε για πιο σταθερή προβολή κάμερας.
generate_audio (Boolean)
Ενεργοποίηση συγχρονισμένης παραγωγής ήχου. Αυτό αυξάνει τη χρήση της πίστωσης.
prompt_directory_optin (Boolean)
Προαιρετικό. Μοιραστείτε τα κατάλληλα prompt στον κατάλογο prompt και εφαρμόστε έκπτωση όταν υποστηρίζεται.
Απόκριση επιτυχίας (200)
{
"success": true,
"generation_id": "abc12345-1234-1234-1234-123456789012",
"task_id": "seedance_task_xyz789",
"credits_used": 40,
"directory_discount_applied": true,
"message": "Video generation started. This may take a few minutes."
}
/seedance/status/{generation_id}/
Κατάσταση εργασίας δημοσκόπησης
Δημοσκοπήστε αυτό το τελικό σημείο μέχρι να φύγει η εργασία processing. Σε περίπτωση επιτυχίας, λαμβάνετε πίσω μια διεύθυνση URL βίντεο. στην αποτυχία
θα πρέπει να επιθεωρήσετε το σφάλμα και να προσπαθήσετε ξανά με διορθωμένο ωφέλιμο φορτίο.
Επεξεργασία απάντησης
{
"success": true,
"status": "processing",
"message": "Video is being generated..."
}
Απόκριση επιτυχίας (200)
{
"success": true,
"status": "completed",
"video_url": "https://media.ulazai.com/seedance_outputs/video.mp4"
}
Παραδείγματα κώδικα: cURL, Python και JavaScript
Η πλήρης ροή είναι υποβολή → κατάστημα generation_id → κατάσταση δημοσκόπησης. Εδώ είναι η κλήση δημιουργίας σε τρεις κοινές στοίβες. ανταλλάξτε το δικό σας κλειδί και το prompt.
ΚΟΥΡΛ
curl -X POST https://api.ulazai.com/seedance/generate/ \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "A cinematic close-up of a chef flipping noodles in slow motion",
"aspect_ratio": "16:9",
"resolution": "1080p",
"duration": "4"
}'
Python (αιτήματα)
import time, requests
BASE = "https://api.ulazai.com"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}
# 1. Start the job
job = requests.post(f"{BASE}/seedance/generate/", headers=HEADERS, json={
"prompt": "A cinematic close-up of a chef flipping noodles in slow motion",
"aspect_ratio": "16:9",
"resolution": "1080p",
"duration": "4",
}).json()
generation_id = job["generation_id"]
# 2. Poll until it leaves "processing"
while True:
status = requests.get(f"{BASE}/seedance/status/{generation_id}/", headers=HEADERS).json()
if status.get("status") == "completed":
print("Video:", status["video_url"])
break
if status.get("status") == "failed":
raise RuntimeError(status)
time.sleep(8) # back off; do not hammer generate
JavaScript (ανάκτηση)
const BASE = "https://api.ulazai.com";
const HEADERS = { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" };
const job = await fetch(`${BASE}/seedance/generate/`, {
method: "POST",
headers: HEADERS,
body: JSON.stringify({
prompt: "A cinematic close-up of a chef flipping noodles in slow motion",
aspect_ratio: "16:9",
resolution: "1080p",
duration: "4",
}),
}).then(r => r.json());
const id = job.generation_id;
let video;
while (!video) {
const s = await fetch(`${BASE}/seedance/status/${id}/`, { headers: HEADERS }).then(r => r.json());
if (s.status === "completed") video = s.video_url;
else if (s.status === "failed") throw new Error(JSON.stringify(s));
else await new Promise(r => setTimeout(r, 8000)); // poll every ~8s
}
console.log("Video:", video);
Ροή χρήσης
- Ανεβάστε μία ή δύο εικόνες οδηγών με
/seedance/upload/μόνο εάν χρειάζεστε καθοδήγηση εικόνας σε βίντεο. - Καλέστε
/seedance/generate/με το prompt, ρυθμίσεις εξόδου και προαιρετικάinput_urls. - Αποθηκεύστε τα επιστρεφόμενα
generation_id. - Δημοσκόπηση
/seedance/status/{generation_id}/έως ότουstatusγίνεταιcompleted. - Χρησιμοποιήστε το επιστρεφόμενο
video_urlγια λήψη, ενσωμάτωση ή μεταβίβαση του τελικού στοιχείου στη δική σας ροή εργασίας.
Κωδικοί σφαλμάτων
400 Μη έγκυρες παράμετροι αιτήματος
401 Ο έλεγχος ταυτότητας απέτυχε (λείπει ή δεν είναι έγκυρο το κλειδί API)
402 Ανεπαρκείς πιστώσεις
429 Υπέρβαση του ορίου τιμής
500 Σφάλμα εσωτερικού διακομιστή
Όρια τιμών και τιμών
Η χρέωση Seedance στο UlazAI εκτελείται με πιστώσεις, επομένως το κόστος κλιμακώνεται με ανάλυση και διάρκεια αντί για σταθερή τιμή ανά δευτερόλεπτο. Χρησιμοποιήστε αυτό ως οδηγό προγραμματισμού. το κόστος της ζωντανής πίστωσης εμφανίζεται στο πακέτα και κατόπιν αιτήματος.
| Έξοδος | Τυπική χρήση | Οδηγός κόστους |
|---|---|---|
480p | Πρόχειρα και γρήγορες επαναλήψεις | Οι χαμηλότερες πιστώσεις ανά δευτερόλεπτο |
720p | Κοινωνικά έτοιμα κλιπ | Μέσες πιστώσεις ανά δευτερόλεπτο |
1080p | Τελική παράδοση | Υψηλότερες πιστώσεις ανά δευτερόλεπτο. οι μεγαλύτερες διάρκειες κοστίζουν περισσότερο |
Όρια τιμών και χειρισμός 429: εάν υποβάλετε πολλές θέσεις εργασίας παράλληλα μπορεί να λάβετε 429 Rate limit exceeded. Αντιμετωπίστε το API ως βασισμένο σε εργασία: υποβάλετε, αποθηκεύστε το generation_id, και δημοσκόπηση /seedance/status/{generation_id}/ κάθε 5-10 δευτερόλεπτα αντί να δημιουργείται σφυρηλάτηση. Σε ένα 429, υποχωρήστε εκθετικά (για παράδειγμα 2s, 4s, 8s) πριν προσπαθήσετε ξανά.
Seedance 1.5 Pro εναντίον Seedance 2.0: αυτή η αναφορά καλύπτει bytedance/seedance-1.5-pro, το μοντέλο αυτή τη στιγμή είναι συνδεδεμένο στο Video Studio. Η ByteDance παρουσίασε έκτοτε το Seedance 2.0 ως την επόμενη γενιά. Όταν είναι ενεργοποιημένο εδώ, χρησιμοποιεί την ίδια ροή δημιουργίας και δημοσκόπησης και την ίδια ταυτότητα, επομένως ο κώδικας ενσωμάτωσης δεν αλλάζει — αλλάζει μόνο το αναγνωριστικό μοντέλου.
Συχνές ερωτήσεις
Υποστηρίζει το UlazAI Seedance API Seedance 2.0 και 2.5;
Το API δημιουργεί με bytedance/seedance-1.5-pro σήμερα. Η ByteDance κυκλοφόρησε το Seedance 2.0 τον Φεβρουάριο του 2026 και έκτοτε έχει δείξει το 2.5. Όταν μια νεότερη έκδοση είναι ενεργοποιημένη εδώ, χρησιμοποιεί την ίδια ταυτότητα φορέα και τα ίδια τελικά σημεία δημιουργίας και δημοσκόπησης, επομένως ο κώδικας ενσωμάτωσής σας δεν αλλάζει — αλλάζει μόνο το αναγνωριστικό μοντέλου.
Πώς σχετίζεται το UlazAI με το επίσημο Seedance / ARK API της ByteDance;
Το Seedance είναι το μοντέλο της ίδιας της ByteDance, που προσφέρεται μέσω της πλατφόρμας Volcano Engine ARK της ByteDance. Το UlazAI είναι ένα επίπεδο API τρίτου κατασκευαστή που εκτελεί το Seedance πίσω από μία απλοποιημένη διαδρομή με ένα μόνο κλειδί φορέα, μεταφόρτωση φιλοξενούμενης εικόνας και κοινόχρηστο πορτοφόλι πίστωσης — χωρίς λογαριασμό ARK ή μη επεξεργασμένα τελικά σημεία για διαχείριση.
Πώς μπορώ να ανεβάσω μια εικόνα για εικόνα σε βίντεο Seedance;
Στείλτε την εικόνα ως πολυμερή/φόρμα-δεδομένα στο POST /seedance/upload/ με το κλειδί του φορέα σας. Η απάντηση επιστρέφει μια μόνιμη διεύθυνση URL. περάστε το (έως δύο) στο input_urls συστοιχία επάνω POST /seedance/generate/. Τα prompt μόνο με κείμενο παραλείπουν το βήμα μεταφόρτωσης.
Πόσο κοστίζει το Seedance API;
Η χρέωση γίνεται με πιστώσεις, επομένως το κόστος κλιμακώνεται με ανάλυση και διάρκεια. Ένα σύντομο πρόχειρο 480p κοστίζει τις λιγότερες πιστώσεις. μια απόδοση 1080p 12 δευτερολέπτων με ήχο κοστίζει περισσότερο. Το ακριβές κόστος φαίνεται στο πακέτα και πάλι ως credits_used στην απόκριση δημιουργίας.
Είναι το Seedance διαθέσιμο παγκοσμίως μέσω του API;
Ναι. Καλείτε τα φιλοξενούμενα τελικά σημεία HTTPS του UlazAI με κλειδί φορέα, επομένως δεν απαιτείται VPN, περιφερειακός τρόπος αντιμετώπισης ή αριθμός τηλεφώνου στα Κινεζικά. Οποιοσδήποτε διακομιστής που μπορεί να υποβάλει ένα πιστοποιημένο αίτημα HTTPS μπορεί να υποβάλει εργασίες και δημοσκόπηση για αποτελέσματα.