ByteDance: Seedance 2.5

Seedance 2.5 mencipta video daripada teks serta rujukan imej, video atau audio, dengan aliran kerja penyuntingan dan pemanjangan yang didokumentasikan. Contoh khusus 2.5 menggabungkan imej produk dengan beberapa rujukan pergerakan dan mengaktifkan bunyi yang dijana untuk urutan pengiklanan yang diselaraskan.

Ailoot Ultra · Penjanaan video POST /v1/videos doubao-seedance-2-5-260628

Tentang model

Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.

Seedance 2.5 mencipta video menggunakan adegan bertulis dan rujukan multimodal. Pemilih doubao-seedance-2-5-260628 mempunyai operasi dan contohnya sendiri yang didokumentasikan. Operasi itu menerangkan penjanaan, penyuntingan dan pemanjangan video, dengan imej, video, audio dan teks sebagai media input. Gunakan rujukan untuk menyampaikan penampilan subjek, aksi, pergerakan kamera, gaya dan bunyi, kemudian terangkan hasil yang patut dicipta daripadanya.

Gabungan input merangkumi teks sahaja, imej atau video dengan teks pilihan, imej dengan audio, video dengan audio serta imej, video dan audio bersama. Gabungan yang disenaraikan memasangkan audio dengan media visual dan bukannya menerangkan permintaan yang hanya mengandungi audio. Susun setiap item mengikut peranannya: imej menetapkan subjek atau rupa, video menunjukkan pergerakan atau adegan sedia ada dan audio membekalkan rujukan bunyi. Nyatakan peranan yang penting untuk syot yang diminta supaya rujukan latar belakang tidak disalah anggap sebagai watak utama.

Contoh khusus 2.5 ialah urutan pengiklanan produk. Contoh itu membekalkan imej dan beberapa rujukan video, kemudian menerangkan fokus pembukaan, susunan produk berurutan, syot butiran, aksi gerak perlahan dan komposisi jenama penutup. Permintaan menetapkan peranan reference_image dan reference_video serta menggunakan rujukan masing-masing untuk komposisi, pergerakan, kerja kamera dan impak. Ini memberikan struktur praktikal untuk konsep kempen: rancang peringkat visual, kenal pasti rujukan untuk setiap peringkat dan nyatakan susunan akhir.

Urutan bertulis boleh membezakan perkara yang berlaku daripada cara ia dirakam. Terangkan aksi produk terlebih dahulu, kemudian saiz syot, laluan kamera, tempo dan peralihan kepada pandangan seterusnya. Jika satu rujukan menentukan produk dan rujukan lain menunjukkan pergerakan kamera, nyatakan tanggungjawab berasingan itu. Untuk adegan dengan beberapa objek, terangkan kedudukan dan urutan interaksinya. Periksa hasil yang dijana untuk bentuk produk, susunan dan pergerakan sebenar, bukannya menganggap setiap butiran rujukan muncul tanpa perubahan.

Untuk suntingan, kenal pasti video sedia ada dan elemen yang hendak disemak, seperti latar, aksi atau gaya visual, sambil menyatakan kesinambungan yang perlu dikekalkan. Untuk pemanjangan, terangkan cara adegan patut berterusan daripada rakaman yang dibekalkan. Semak sambungan dan juga segmen baharu: penampilan subjek, arah pergerakan, kedudukan kamera dan pemasaan bunyi semuanya mempengaruhi sama ada hasil membentuk satu adegan. Simpan video asal dan semakan yang siap bersama supaya perubahan boleh disemak berdasarkan kesinambungan yang dimaksudkan.

Contoh multimodal 2.5 yang didokumentasikan menetapkan generate_audio=true dan meminta urutan lima belas saat dengan pembingkaian 16:9. Nilai itu menerangkan contoh tersebut dan bukannya had tempoh yang terpakai secara umum atau had aset rujukan. Berikan maksud bunyi yang jelas kepada adegan yang diminta, termasuk hubungan antara muzik, kesan bunyi dan aksi yang kelihatan, kemudian nilai output audiovisual sebenar. Rujukan bunyi dan runut bunyi yang dijana patut disemak bersama untuk tempo dan persembahan yang dimaksudkan.

Pilih tempoh, pembingkaian dan resolusi daripada tetapan yang ditawarkan untuk profil khusus ini. Simpan konfigurasi yang diminta bersama prom dan bandingkan dengan medan tugasan sebenar yang dikembalikan. Gunakan tempoh, resolusi dan nisbah yang dikembalikan apabila menyediakan klip siap untuk destinasinya. Kekalkan pengecam profil yang tepat dalam rekod semakan supaya perbandingan kemudian menggunakan edisi terpilih yang sama.

Penggunaan token video dikira sebagai (tempoh video input + tempoh video output) × lebar output × tinggi output × kadar bingkai output / 1024. Permintaan yang mengandungi video input dan permintaan tanpa video input mempunyai kategori pengebilan berbeza. Pertanyaan tugasan melaporkan usage.completion_tokens dan usage.total_tokens; simpan kuantiti yang dilaporkan ini bersama klip yang selesai.

Penjanaan berlaku secara tak segerak. Penyerahan mengembalikan pengecam, dan aliran tugasan yang dikonfigurasi menyediakan status diikuti content.video_url selepas berjaya. Simpan klip siap bersama media sumber dan arahan urutan. Semak semua peringkat yang dirancang, interaksi objek, penampilan watak, pembingkaian dan penjajaran bunyi merentasi seluruh hasil. Untuk semakan, kenal pasti butiran khusus yang tidak dipenuhi dan kekalkan bahagian adegan yang berjaya, bukannya menggantikan seluruh arahan dengan instruksi yang tidak berkaitan.

Ailoot Ultra · Penjanaan video POST /v1/videos doubao-seedance-2-5-260628

doubao-seedance-2-5-260628

ByteDance /doubao-seedance-2-5-260628

Pengenalan

Input yang diterima: Teks · Imej · Video · Audio
Hasil: Video

Tersedia di Ailoot · input & kaedah

Ailoot Ultra · Penjanaan video POST /v1/videos

Input: text, image, video, audio
Output: video

Medan	Jenis	Keperluan	Nilai & had	Lalai
Medan`model`	Jenis`string`	KeperluanDiperlukan	Nilai & had doubao-seedance-2-5-260628	Lalai—
Medan`content`	Jenis`array`	KeperluanDiperlukan	Nilai & had Syarat: Objek teks/media natif; tatasusunan luar mesti tidak kosong. Jenis nod bersarang tidak disahkan oleh pembina generik Ailoot ini.	Lalai—
Medan`generate_audio`	Jenis`boolean`	KeperluanPilihan	Nilai & had Syarat: Contoh 2.5 menetapkan true tetapi huraian pemilih yang disalin hanya menyenaraikan 2.0/fast/1.5; tiada jaminan tetapan/nilai lalai yang lebih luas.	Lalai—
Medan`duration`	Jenis`integer`	KeperluanPilihan	Nilai & had Syarat: Nilai literal 15 dalam contoh 2.5 bukan nilai maksimum atau lalai.	Lalai—
Medan`resolution`	Jenis`string`	KeperluanPilihan	Nilai & had Syarat: Tiada nilai lalai/enum khusus 2.5 disimpulkan daripada huraian yang disalin.	Lalai—
Medan`ratio`	Jenis`string`	KeperluanPilihan	Nilai & had Syarat: Mod adaptive dinyatakan secara jelas untuk 2.0/fast/1.5; contoh 2.5 hanya menggunakan 16:9.	Lalai—
Medan`watermark`	Jenis`boolean`	KeperluanPilihan	Nilai & had	Lalaifalse
Medan`seed`	Jenis`integer`	KeperluanPilihan	Nilai & had Minimum: -1 Maksimum: 4,294,967,295	Lalai-1
Medan`execution_expires_after`	Jenis`integer`	KeperluanPilihan	Nilai & had Minimum: 3,600 Maksimum: 259,200 Unit: saat	Lalai172,800
Medan`service_tier`	Jenis`string`	KeperluanPilihan	Nilai & had Syarat: 2.0/fast mengecualikan flex luar talian; skop 2.5 belum ditetapkan.	Lalai—
Medan`safety_identifier`	Jenis`string`	KeperluanPilihan	Nilai & had	Lalai—

Gabungan bahan input

Parameter kaedah dan kitar hayat

Parameter	Kontrak
Parameter`content_type`	Kontrakapplication/json
Parameter`required`	Kontrakcontent, model
Parameter`optional`	Kontrakgenerate_audio, duration, resolution, ratio, watermark, seed, execution_expires_after, service_tier, safety_identifier
Parameter`material_types`	Kontraktext, image, video, audio
Parameter`additional_properties`	Kontraktrue
Parameter`validation_scope`	KontrakAiloot menyemak jenis medan wajib dan memastikan model serta tatasusunan content tidak kosong. Medan permintaan lain dikekalkan untuk model yang dipilih.
Parameter`material_combinations`	Kontraktext, image, video, image, audio, image, video, video, audio, image, video, audio
Parameter`optional_text_with_media`	Kontraktrue
Parameter`reference_media_count_and_size_limits`	Kontraknull

Alias kaedah: /v1/videos/generations

Kitar hayat: 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

Cipta sekali dan simpan id/polling_url awam yang dikembalikan.

Semak tugas asal secara berkala; muat turun content.video_url sebenar milik anda selepas succeeded.

Pelan harga

Cara caj akhir dikira

Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira berdasarkan kos yang direkodkan untuk penjanaan asal. Tempoh output yang diukur dan kuantiti ramalan bukan kuantiti akhir yang boleh dibilkan.

Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.

Mod pantas: Tidak dinyatakan Apabila mod pantas dipilih
Mod flex: Tidak dinyatakan Apabila mod flex dipilih
Usaha penaakulan maksimum: Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default

Anggaran kadar untuk perbandingan

Harga mengikut konfigurasi

Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.

Konfigurasi	Jadual kadar	Kuantiti ramalan	Unit pengebilan	Caj
KonfigurasiKadar asas token	Jadual kadarKadar asas	Kuantiti ramalan—	Unit pengebilan—	Caj Input · Token input · Anggaran untuk perbandingan sahaja — / 1K token Output · Token output · Anggaran untuk perbandingan sahaja — / 1K token Input · Bacaan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache · Anggaran untuk perbandingan sahaja — / 1K token Input · Penulisan cache, 1 jam · Anggaran untuk perbandingan sahaja — / 1K token
KonfigurasiInput mengandungi rujukan video.	Jadual kadar—	Kuantiti ramalan—	Unit pengebilanbagi setiap 1K token video	Caj Output · Anggaran untuk perbandingan sahaja $0.012 bagi setiap 1K token video
KonfigurasiInput tidak mengandungi rujukan video.	Jadual kadar—	Kuantiti ramalan—	Unit pengebilanbagi setiap 1K token video	Caj Output · Anggaran untuk perbandingan sahaja $0.02 bagi setiap 1K token video
KonfigurasiAnggaran kos penjanaan	Jadual kadar—	Kuantiti ramalananggaran untuk satu penjanaan	Unit pengebilan—	Caj Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja $0.822402 anggaran sebelum penjanaan Anggaran ini bukan caj tambahan atau kadar tetap bagi penjanaan yang telah selesai.

Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →

Contoh permintaan

Ailoot Ultra · Penjanaan video

curl · cipta videocurl · baca tugas asalcurl · muat turun video milik anda

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

Terima dan simpan hasil

Ailoot Ultra · Penjanaan video

JSON natif dengan id/polling_url awam. Selepas penerbitan, content.video_url mengandungi URL bertandatangan milik Ailoot; sebelum penerbitan, URL output yang dipilih dikosongkan.

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Simpan semua hasil yang selesai

Simpan setiap video yang selesai atau fail yang dikembalikan; dapatkan setiap URL aset yang benar-benar dikembalikan.

Simpan setiap URL sebenar dalam content.video_url; index mesti mengenal pasti output sebenar yang dikembalikan.

Jika respons asal perlu disemak

Simpan respons/pengepala/id asal dan semak operasi tersebut secara berkala; jangan sekali-kali hantar semula penciptaan yang tidak diketahui hasilnya.

Medan respons

Medan	Jenis
Medan`id`	Jenisstring
Medan`provider_task_id`	Jenisstring
Medan`polling_url`	Jenisstring
Medan`status`	Jenisstring when supplied
Medan`content.video_url`	Jenisstring\|string[]
Medan`usage`	Jenisobject when supplied

Ralat dan langkah seterusnya

Respons	Syarat	Langkah seterusnya
Respons400 · `invalid_request_error`	SyaratJSON/model/jenis medan wajib atau indeks kandungan tidak sah.	Langkah seterusnya
Respons401 · `authentication_error`	SyaratKunci API Ailoot tidak sah.	Langkah seterusnya
Respons404 · `not_found_error`	SyaratTugas/output tiada atau bukan milik pengguna/kunci API/kumpulan yang sama.	Langkah seterusnya
Respons502 · `result_pending_check`	SyaratPenghantaran/status asal tidak lengkap; simpan ID asal, jangan hantar semula.	Langkah seterusnya
Respons503 · `result_pending_check`	SyaratMedia/laluan/penyelesaian caj asal sedang disemak; teruskan operasi asal.	Langkah seterusnya

Alias

Alias model

Ailoot Ultra doubao-seedance-2-5-260628

Alias laluan kaedah

/v1/videos/generations

ID pemanggil berkaitan

doubao-seedance-2-5-260628

FAQ · ByteDance: Seedance 2.5

Apakah input dan hasil yang tersedia?: POST /v1/videos · doubao-seedance-2-5-260628: text, image, video, audio → video
Apakah medan yang digunakan oleh permintaan?: POST /v1/videos · doubao-seedance-2-5-260628: model, content, generate_audio, duration, resolution, ratio, watermark, seed, execution_expires_after, service_tier, safety_identifier
Apakah had yang terpakai?: 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