ByteDance: Seedance 1.0 Pro
Seedance 1.0 Pro menghasilkan video tanpa suara dari teks atau gambar pembuka. Jelaskan aksi dan kamera, atau animasikan komposisi yang ada, dengan durasi 2–12 detik, 24 fps, serta kontrol bingkai dan resolusi keluaran yang eksplisit.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Seedance 1.0 Pro menghasilkan video dari teks atau adegan yang dipandu gambar. Selektor doubao-seedance-1-0-pro-250528 mendukung kedua mode masukan, sehingga titik awal dapat berupa konsep tertulis atau komposisi visual yang ada. Gunakan arahan teks untuk membuat adegan baru, atau berikan gambar ketika subjek, susunan, dan tampilan pembuka perlu ditetapkan secara visual. Profil 1.0 ini menghasilkan video tanpa suara; suara tersinkronisasi merupakan kemampuan profil 1.5 Pro yang dijelaskan terpisah.
Untuk teks-ke-video, tentukan subjek, lingkungan, gerakan, bingkai, dan kamera dalam satu adegan yang koheren. Contoh yang didokumentasikan bergerak secara bertahap dari hamparan bunga daisy menuju tampilan dekat bunga dengan embun pada kelopaknya. Struktur itu berguna untuk pengungkapan lain: perkenalkan latar, bergerak mendekati subjek, dan akhiri pada detail yang penting. Untuk konsep produk, jelaskan bahan dan pencahayaan bersama aksi, serta berikan jalur kamera yang dapat dicapai dalam pengambilan gambar singkat.
Untuk gambar-ke-video, letakkan rujukan dalam item content berjenis image_url dan jelaskan perubahan yang diinginkan dari tampilan awal tersebut. Potret yang disiapkan dapat menentukan orang dan potongan gambar, sementara arahan menjelaskan putaran kecil, rambut bergerak, atau kamera perlahan menjauh. Foto produk dapat menetapkan objek dan latar belakang, sementara prompt meminta pengungkapan yang terkendali. Pastikan gerakan yang diminta sesuai dengan komposisi sumber; gambar satu sisi objek tidak menyediakan tampilan akurat setiap sisi lain yang tidak terlihat.
Bidang gambar menerima URL yang dapat diakses atau URL data yang berisi data gambar Base64. Format yang didokumentasikan adalah JPEG, PNG, WEBP, BMP, TIFF, dan GIF. Gambar harus berukuran kurang dari 30 MB, dengan rasio lebar terhadap tinggi lebih dari 0.4 dan kurang dari 2.5, serta setiap dimensi lebih dari 300 dan kurang dari 6000 piksel. Siapkan sumber yang jelas dengan potongan gambar yang dituju, alih-alih mengandalkan gambar mini yang detail penentunya sudah hilang. Untuk generasi gambar-ke-video, panduan merekomendasikan bingkai adaptif agar mengikuti proporsi rujukan.
Durasi 1.0 yang didokumentasikan adalah dua hingga dua belas detik dan laju bingkainya 24 fps. Kontrol keluaran mencakup tingkat 480p, 720p, dan 1080p, dengan 1080p sebagai bawaan Pro; panduan mengecualikan 1080p dalam skenario gambar rujukan. Bentuk tetap mencakup 16:9, 4:3, 1:1, 3:4, 9:16, dan 21:9. Pilih kombinasi yang kompatibel dengan gambar untuk pengambilan gambar yang berawal dari gambar, alih-alih memindahkan setiap pengaturan teks-ke-video tanpa perubahan. Periksa bingkai yang benar-benar dikembalikan sebelum menempatkan klip dalam tata letak.
Kontrol seed dan watermark didokumentasikan bersama camerafixed. Instruksi kamera tetap tidak didukung dalam skenario gambar rujukan, dan pada penggunaan yang didukung, panduan tidak menjamin kamera yang benar-benar diam. Instruksi parameter yang disisipkan dalam prompt lebih diutamakan daripada bidang opsional terpisah. Pertahankan satu pengaturan acuan untuk durasi, resolusi, dan rasio, serta sesuaikan deskripsi kamera dengannya. Ini mencegah arahan adegan diam-diam menimpa pengaturan yang dipilih untuk permintaan.
Pemakaian diukur dalam token video: lebar keluaran × tinggi keluaran × laju bingkai × durasi keluaran / 1024. Tugas yang selesai melaporkan jumlah ini sebagai usage.completion_tokens. Simpan pemakaian yang dilaporkan bersama klip jadi dan pengaturan yang diminta.
Alur kerja mengembalikan pengenal tugas terlebih dahulu dan lokasi video jadi setelah pemrosesan. Simpan pengenal saat memeriksa status queued atau running; tugas berstatus succeeded menyediakan content.video_url dan informasi pemakaian. Masa penyimpanan berkas yang dihasilkan yang didokumentasikan adalah tujuh hari. Simpan klip jadi, gambar sumber, dan prompt yang tepat sebagai catatan revisi, lalu periksa penampilan subjek, gerakan, kesinambungan gambar, dan komposisi penutup di seluruh hasil.
Ailoot Ultra · Pemrosesan video POST /v1/videos doubao-seedance-1-0-pro-250528
doubao-seedance-1-0-pro-250528
doubao-seedance-1-0-pro-250528Mulai
Seedance 1.0 Pro menghasilkan video tanpa suara dari teks atau gambar pembuka. Jelaskan aksi dan kamera, atau animasikan komposisi yang ada, dengan durasi 2–12 detik, 24 fps, serta kontrol bingkai dan resolusi keluaran yang eksplisit.
- Masukan yang diterima
- Teks · Gambar
- Hasil
- Video
Tersedia di Ailoot · masukan & metode
Ailoot Ultra · Pemrosesan video POST /v1/videos
- Masukan
text,image- Keluaran
video
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan doubao-seedance-1-0-pro-250528 | Bawaan— |
Kolomcontent | Jenisarray | PersyaratanWajib | Nilai & batasan Kondisi: Objek teks/media native; array terluar harus tidak kosong. Tipe simpul bertingkat tidak divalidasi oleh konstruktor generik Ailoot ini. | Bawaan— |
Kolomduration | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 2 Maksimum: 12 Kondisi: Skema utama 1.x menetapkan 2–12; deskripsi bersama yang lebih baru menyebut 1.5 sebagai 4–12 atau -1. Contoh menggunakan 5 yang didokumentasikan oleh keduanya. | Bawaan5 |
Kolomresolution | Jenisstring | PersyaratanOpsional | Nilai & batasan Kondisi: Nilai teks-ke-video yang telah dikonfirmasi adalah 480p dan 1080p. Masukan gambar referensi mengecualikan 1080p. Enum 720p bersama bertentangan dengan uraian khusus model, sehingga dukungan 720p masih belum dipastikan dalam kedua mode. | Bawaan1080p |
Kolomratio | Jenisstring | PersyaratanOpsional | Nilai & batasan 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive Kondisi: Nilai bawaan bergantung pada adegan/model; dokumentasi masukan gambar menyarankan adaptive. | Bawaan— |
Kolomservice_tier | Jenisstring | PersyaratanOpsional | Nilai & batasan default, flex Kondisi: default=online, flex=offline; pilih sebelum pembuatan. | Bawaandefault |
Kolomseed | Jenisinteger | PersyaratanWajib | Nilai & batasan Minimum: -1 Maksimum: 4.294.967.295 | Bawaan-1 |
Kolomcamerafixed | Jenisboolean | PersyaratanWajib | Nilai & batasan Kondisi: Diwajibkan oleh Ailoot; kontrol kamera pada gambar referensi didokumentasikan sebagai tidak didukung dan efeknya tidak dijamin. | Bawaanfalse |
Kolomwatermark | Jenisboolean | PersyaratanWajib | Nilai & batasan | Bawaanfalse |
Kolomexecution_expires_after | Jenisinteger | PersyaratanWajib | Nilai & batasan Minimum: 3.600 Maksimum: 259.200 Satuan: detik | Bawaan172.800 |
Kombinasi bahan masukan
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakcamerafixed, content, execution_expires_after, model, seed, watermark |
Parameteroptional | Kontrakduration, resolution, ratio, service_tier |
Parametermaterial_types | Kontraktext, image |
Parameteradditional_properties | Kontraktrue |
Parametervalidation_scope | KontrakAiloot memeriksa tipe bidang wajib serta model dan array content yang tidak kosong. Bidang permintaan lainnya dipertahankan untuk model yang dipilih. |
Parameterimage_constraints | Kontrak{"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} |
Alias metode: /v1/videos/generations
Siklus hidup: 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
Buat sekali dan simpan id/polling_url publik yang dikembalikan.
Periksa tugas awal secara berkala; unduh content.video_url aktual milik Ailoot setelah succeeded.
Paket
Cara menghitung biaya akhir
Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
- Mode Fast
- Tidak ditentukan Saat mode fast dipilih
- Mode Flex
- Tidak ditentukan Saat mode flex dipilih
- Upaya penalaran maksimum
- Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default
Perkiraan tarif untuk perbandingan
Harga menurut konfigurasi
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Jumlah perkiraan | Satuan penagihan | Biaya |
|---|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Jumlah perkiraan— | Satuan penagihan— | Biaya Masukan · Token masukan · Perkiraan hanya untuk perbandingan — / 1K token Keluaran · Token keluaran · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Pembacaan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache, 1 jam · Perkiraan hanya untuk perbandingan — / 1K token |
| KonfigurasiUltra | Jadwal tarif— | Jumlah perkiraan— | Satuan penagihanper 1K token video | Biaya Keluaran · Perkiraan hanya untuk perbandingan $0.0044 per 1K token video |
| KonfigurasiPerkiraan biaya pembuatan | Jadwal tarif— | Jumlah perkiraanestimasi satu kali pembuatan | Satuan penagihan— | Biaya Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.2112 estimasi sebelum pembuatan Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai. |
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Contoh permintaan
Ailoot Ultra · Pemrosesan video
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
Terima dan simpan hasil
Ailoot Ultra · Pemrosesan video
JSON native dengan id/polling_url publik. Setelah publikasi, content.video_url memuat URL bertanda tangan milik Ailoot; sebelum publikasi, URL keluaran yang dipilih dikosongkan.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Simpan semua hasil yang selesai
Simpan setiap video yang selesai atau berkas yang dikembalikan; ambil setiap URL aset yang benar-benar dikembalikan.
Simpan setiap URL aktual dalam content.video_url; index harus mengidentifikasi keluaran nyata yang dikembalikan.
Jika respons asli perlu diperiksa
Simpan respons/header/id asli dan periksa operasi tersebut secara berkala; jangan pernah kirim ulang pembuatan yang statusnya tidak diketahui.
Kolom respons
| Kolom | Jenis |
|---|---|
Kolomid | Jenisstring |
Kolomprovider_task_id | Jenisstring |
Kolompolling_url | Jenisstring |
Kolomstatus | Jenisstring when supplied |
Kolomcontent.video_url | Jenisstring|string[] |
Kolomusage | Jenisobject when supplied |
Kesalahan dan langkah berikutnya
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiJSON/model/tipe bidang wajib atau indeks content tidak valid. | Langkah berikutnya |
Respons401 · authentication_error | KondisiKunci API Ailoot tidak valid. | Langkah berikutnya |
Respons404 · not_found_error | KondisiTugas/keluaran tidak ada atau tidak dimiliki oleh pengguna/kunci API/grup yang sama. | Langkah berikutnya |
Respons502 · result_pending_check | KondisiPengiriman/status awal tidak lengkap; simpan ID asli, jangan kirim ulang. | Langkah berikutnya |
Respons503 · result_pending_check | KondisiMedia/rute/penyelesaian tagihan awal sedang diperiksa; lanjutkan operasi awal. | Langkah berikutnya |
Alias
Alias model
Ailoot Ultra doubao-seedance-1-0-pro-250528
Alias jalur metode
/v1/videos/generations
ID pemanggil terkait
FAQ · ByteDance: Seedance 1.0 Pro
- Input dan hasil apa yang tersedia?
POST /v1/videos·doubao-seedance-1-0-pro-250528:text,image→video- Kolom apa yang digunakan permintaan?
POST /v1/videos·doubao-seedance-1-0-pro-250528:model,content,duration,resolution,ratio,service_tier,seed,camerafixed,watermark,execution_expires_after- Batasan apa yang berlaku?
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