API Seedance 2.5: Panduan Developer untuk Endpoint, Autentikasi, dan Generasi Video

API Seedance 2.5: Panduan Developer untuk Endpoint, Autentikasi, dan Generasi Video

Seedance 2.5 adalah model video multimodal dengan durasi panjang, yang berarti API yang menjalankannya bersifat asinkron, bukan sekadar permintaan-respon sekali jalan. Anda mengirimkan task generasi, melakukan polling hingga selesai, lalu mengunduh hasilnya. Setelah Anda memahami pola tersebut, ditambah endpoint, header autentikasi, dan field payload untuk durasi, resolusi, serta referensi, sisanya berjalan lancar.

Panduan ini membahas kontrak API Seedance 2.5 secara menyeluruh: endpoint, autentikasi, body request, polling asinkron, serta contoh curl dan Python yang berfungsi. Panduan ini menargetkan rute api-platform PixMind, yang mencerminkan kontrak ByteDance untuk model tersebut. Panduan ini juga menambahkan perbandingan langsung dengan pola API Seedance 2.0 dan Kling, studi kasus pipeline produksi end-to-end, resource developer pihak ketiga, serta FAQ yang diperluas mencakup rate limit, konkurensi, webhook, dan pengecekan kredit. Semua detail endpoint dan autentikasi telah diverifikasi terhadap backend live per 2026-07-31.

Ringkasan model Seedance 2.5

Poin-poin Penting

• Endpoint: POST /api-platform/v1/generations untuk membuat task; GET /api-platform/v1/task/{task_id} untuk melakukan polling hasil.
• Autentikasi: Authorization: Bearer <API_KEY> (atau header X-API-Key); buat kunci dengan scope video di dashboard PixMind.
• Payload: { model, prompt, duration, resolution, aspect_ratio, reference_images, reference_videos, generate_audio }.
• Bersifat asinkron: panggilan create mengembalikan taskId; lakukan polling hingga status bernilai ready, lalu baca videoUrl.
• Bentuk lintas penyedia: Seedance 2.5, Seedance 2.0, dan Kling semuanya memakai pola submit-lalu-poll yang sama. Mereka berbeda di path endpoint, alokasi referensi, dan nama field.
• Pola produksi: tambahkan Idempotency-Key saat create, lakukan polling dengan retry terbatas dan backoff, verifikasi kredit sebelum submit, dan sediakan rute yang lebih murah sebagai fallback untuk iterasi.
• Akses API akan segera hadir di PixMind; rute sudah didokumentasikan dan siap, koneksi backend sedang difinalisasi.

Prasyarat: Dapatkan API Key

Panggilan ke Seedance 2.5 diautentikasi dengan API key yang ter-scoped ke akun Anda. Buatlah satu di dashboard api-platform PixMind dan simpan dengan aman; perlakukan ia seperti secret lainnya. Muat kunci tersebut dari environment variable di dalam kode, alih-alih memasukkannya ke source control:

export PIXMIND_API_KEY="pk-xxxxxxxxxxxxxxxx"

Membuat API key

Di PixMind, permission kunci di-scoped per workload (image / video). Pastikan kunci Anda mengaktifkan permission video sebelum memanggil Seedance 2.5.

Catatan developer: Rotasi kunci per environment (dev / staging / prod) dan batasi setiap kunci hanya ke workload minimum yang ia butuhkan. Sebuah kunci staging dengan scope video saja tidak bisa bocor ke pipeline image, yang mempersempit dampak ledakan jika kunci tersebut terompromi. Terbitkan ulang kunci sesuai jadwal tetap dan catat timestamp penggunaan terakhir, agar kunci yang menganggur mudah ditemukan dan dicabut.

Tonton: Walkthrough Workflow Seedance 2.5

Cara tercepat memahami upgrade 2.5 sebelum menulis kode adalah dengan menonton footage demo resmi dan analisis komunitas. Dua walkthrough berikut mencakup generasi native 30 detik, output 4K, editing level region, dan workflow 50 referensi yang diekspos oleh API:

cadangan noscript: Demo Seedance 2.5 di YouTube, mencakup klip native 30 detik, edit level region, dan 50 referensi multimodal.

Untuk diskusi editorial yang lebih mendalam tentang apa arti peningkatan workflow tersebut bagi sebuah pipeline produksi, analisis "Seedance 2.5 Changes Everything" layak ditonton bersama reel resmi:

cadangan noscript: Seedance 2.5 Changes Everything di YouTube.

Kontrak API Seedance 2.5

Endpoint

Membuat task generasi:

POST /api-platform/v1/generations

Polling hingga selesai:

GET /api-platform/v1/task/{task_id}

Endpoint create adalah entry point generasi terpadu: ia membaca field model dan mendispatch accordingly. Kirim model: "seedance-2.5" dan rute akan menangani pipeline video.

Autentikasi

Kirim API key sebagai Bearer token (kompatibel dengan OpenAI SDK):

Authorization: Bearer $PIXMIND_API_KEY

Middleware autentikasi juga menerima header X-API-Key jika Anda lebih menyukai bentuk tersebut. Keduanya didukung; pilih satu dan gunakan secara konsisten di seluruh kode klien Anda agar log dan retry lebih mudah ditelusuri.

Body Request

Tentang referensi: Seedance 2.5 menerima hingga 50 input multimodal dalam satu permintaan, gabungan gambar, video, teks, dan audio. Beri setiap referensi satu peran eksplisit (identitas, bentuk, gerak, palet, ritme) dan buang aset yang bersaing memperebutkan properti yang sama.

Bagaimana API Seedance 2.5 Dibandingkan dengan Seedance 2.0 dan Kling

Sebagian besar API generasi video saat ini berbagi bentuk asinkron yang sama: satu POST untuk membuat task, satu GET untuk polling hingga selesai. Yang membedakan adalah path endpoint, konvensi autentikasi, alokasi referensi, dan nama field pada payload. Tabel di bawah memetakan perbedaan tersebut untuk ketiga API yang paling sering dibandingkan developer saat merencanakan integrasi.

Pengamatan langsung: Bentuk asinkron yang dibagikan ini berarti kode klien dapat digunakan ulang antar penyedia. Bungkus loop create-dan-poll dalam satu fungsi generate_video(model, payload) dan tukar ID modelnya, maka Anda bisa melakukan A/B Seedance 2.5, Seedance 2.0 Fast, dan Kling dari harness yang sama. Itulah cara termurah untuk memilih rute yang tepat per shot tanpa menulis ulang kode integrasi.

Implikasi praktisnya: jika tim Anda sudah membangun klien polling untuk Seedance 2.0, mengadopsi 2.5 hanyalah perubahan string model ditambah field referensi dan durasi baru. Anda tidak perlu mendesain ulang integrasi.

Perbandingan model Seedance 2.5 vs Kling

Langkah 1: Buat Task Generasi

Berikut permintaan create minimal, klip 5 detik, 720p, 16:9 dengan prompt teks. Header Idempotency-Key bersifat opsional namun direkomendasikan untuk setiap submit produksi:

curl -X POST https://aihub-admin.aimix.pro/api-platform/v1/generations \
  -H "Authorization: Bearer $PIXMIND_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "A courier in a yellow jacket cycling through a neon-lit rainy Tokyo street at night, tracking shot, cinematic, no text",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Respon sukses mengembalikan task ID. Anda tidak mendapatkan video di sini, melainkan handle untuk di-poll:

{
  "code": 1000,
  "data": {
    "taskId": "47264",
    "type": "video",
    "status": "processing"
  }
}

Jika Anda melihat code: 400 dengan "模型不存在或未配置", rute backend untuk seedance-2.5 belum diaktifkan di endpoint tersebut. Ini adalah status Coming Soon di PixMind selagi koneksi sedang difinalisasi.

Langkah 2: Polling Task Hingga Ready

Generasi video bersifat asinkron. Lakukan polling ke endpoint task dengan taskId dari langkah 1:

curl -X GET https://aihub-admin.aimix.pro/open-api/v1/task/47264 \
  -H "Authorization: Bearer $PIXMIND_API_KEY"

Field status bergerak dari pending, lalu processing, lalu ready. Polling setiap 3 hingga 5 detik. Saat task sudah ready, respon menyertakan URL video final:

{
  "code": 1000,
  "data": {
    "taskId": "47264",
    "status": "ready",
    "progress": 100,
    "videoUrl": "https://.../seedance-2-5-47264.mp4",
    "coverUrl": "https://.../seedance-2-5-47264-cover.webp"
  }
}

Status kegagalan terminal adalah failed, error, canceled, dan cancelled. Tangani semua status ini dan tampilkan field description ke log Anda.

Catatan developer: Interval polling 3 hingga 5 detik tidak masalah untuk satu task, tetapi bertambah cepat saat skala membesar. Untuk antrean 20 task, lebih baik pakai satu loop dispatcher yang mem-poll setiap task terbuka sekali per siklus, dengan backoff eksponensial (5d, 5d, 10d, 15d, batas atas 30 detik) seiring task menua. Hal ini menjaga volume request tetap sopan tanpa membengkakkan latensi p99 untuk seluruh batch.

Langkah 3: Unduh dan Gunakan Hasil

Setelah status bernilai ready, unduh videoUrl (dan opsional coverUrl untuk frame poster). File tersebut adalah MP4 standar; transcode, host, atau embed sesuai kebutuhan aplikasi Anda.

Untuk landing page web, Anda biasanya akan mengompresnya menjadi klip H.264 8 hingga 10 detik dengan fast-start untuk autoplay, mengekstrak poster WebP, dan menghosting keduanya di CDN Anda sendiri. (PixMind meng-host media kasus Seedance 2.5 di cdn.pixmind.io.) Jangan hotlink videoUrl yang di-host API di production, karena URL API tidak dijamin persisten.

Contoh Python Lengkap

Berikut cuplikan Python lengkap yang dapat dijalankan, yang membuat task, melakukan polling hingga ready, dan mencetak URL video. Cuplikan ini menambahkan Idempotency-Key, loop retry terbatas, dan batas timeout, tiga hal yang dibutuhkan klien production namun biasanya tidak ada di contoh hello-world:

import time
import uuid
import requests

API_BASE = "https://aihub-admin.aimix.pro"
API_KEY = "your-pixmind-api-key"  # scope: video

GEN = f"{API_BASE}/api-platform/v1/generations"
TASK = f"{API_BASE}/open-api/v1/task"
HEADERS = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
}

# 1. Create dengan idempotency key agar retry tidak memulai task kedua yang juga ditagihkan
payload = {
    "model": "seedance-2.5",
    "prompt": "A 30-second continuous hero shot: a character walking through a neon city that flows into a product reveal",
    "duration": 30,
    "resolution": "1080p",
    "aspect_ratio": "16:9",
    "generate_audio": True,
}
headers = {**HEADERS, "Idempotency-Key": str(uuid.uuid4())}
create = requests.post(GEN, headers=headers, json=payload, timeout=30).json()
task_id = create["data"]["taskId"]
print(f"Task created: {task_id}")

# 2. Poll dengan retry terbatas dan backoff lambat
max_attempts, delay = 100, 5
for attempt in range(max_attempts):
    time.sleep(delay)
    t = requests.get(f"{TASK}/{task_id}", headers=HEADERS, timeout=15).json()
    status = t["data"]["status"].lower()
    print(f"attempt={attempt + 1} status={status} progress={t['data'].get('progress', 0)}%")
    if status in ("ready", "succeeded", "completed"):
        print("Video URL:", t["data"]["videoUrl"])
        break
    if status in ("failed", "error", "canceled", "cancelled"):
        raise RuntimeError(f"Task failed: {t['data']}")
    delay = min(delay + 2, 30)  # backoff, batas atas 30 detik
else:
    raise TimeoutError(f"Task {task_id} tidak selesai dalam {max_attempts * 5}s")

Studi Kasus End-to-End: Pipeline Video Produk 30 Detik

Ini adalah bagian yang dilewati sebagian besar panduan API: bagaimana tim nyata merangkai kontrak di atas menjadi pipeline produksi yang dapat diulang. Skenarionya adalah tim kreatif empat orang di sebuah brand D2C yang memproduksi video hero 30 detik untuk peluncuran produk, dengan anggaran tetap dan tenggat yang ketat. Pola di bawah ini adalah bentuk yang konsisten tepat waktu saat dirilis.

Ikhtisar pipeline

Tim membagi kerja menjadi empat tahap: iterasi (uji A/B murah di Seedance 2.0 Fast), generasi final (satu kali run Seedance 2.5 di 1080p / 30 detik), review dan edit region (regenerasi region tertentu dengan Seedance 2.5), serta delivery (transcode, poster, upload ke CDN). Setiap tahap memakai kode klien yang sama; hanya ID model dan payload yang berubah. Pemisahan inilah yang membuat pipeline dapat diulang lintas kampanye.

Alokasi referensi

Sebelum panggilan API apa pun, tim menetapkan setiap referensi satu peran eksplisit, yang dicatat di spreadsheet bersama agar prompt dan payload selalu sinkron. Lima referensi dari alokasi 50 input, masing-masing dengan satu tugas:

Prompt memetakan setiap referensi secara eksplisit: "pertahankan karakter dari @Image 1 tanpa perubahan; samakan produk dengan @Image 2; gunakan @Video 1 hanya untuk gerak kamera; sejajarkan potongan dengan @Audio 1." Pemetaan ini adalah kontrak antara arah kreatif dan payload API. Jika sebuah referensi tidak diberi peran, ia tidak masuk ke request.

Tahap iterasi (pengendalian biaya)

Sebelum menghabiskan dana untuk run 2.5 sepanjang 30 detik, tim memvalidasi prompt dan referensi pada Seedance 2.0 Fast di 5 detik dan 720p. Ini adalah panggilan POST /api-platform/v1/generations yang sama dengan model: "seedance-2.0-fast". Tiga iterasi hanya menghabiskan sebagian kecil dari satu run 2.5 dan mengungkap konflik referensi sebelum anggaran dikomit. Dispatcher mencatat taskId, status, dan detik yang berlalu untuk setiap iterasi, agar creative lead bisa membandingkan varian berdampingan.

Pengamatan langsung: Tim yang melewatkan tahap ini dan langsung lompat ke generasi 2.5 selama 30 detik biasanya membakar tiga atau empat run harga penuh untuk memperbaiki konflik prompt yang sebetulnya bisa tertangkap di Fast. Tahap iterasi adalah bagian pipeline dengan ROI tertinggi, dan tim yang rilis andal adalah mereka yang memperlakukannya sebagai wajib.

Generasi final (Seedance 2.5 di 30 detik / 1080p)

Ketika iterasi Fast mengonfirmasi prompt terbaca baik, tim mengirimkan generasi sebenarnya: model: "seedance-2.5", duration: 30, resolution: "1080p", dengan kelima referensi terlampir dan prompt terpetut per peran yang lengkap. Panggilan create menyertakan Idempotency-Key agar retry jaringan dari runner CI tidak memulai task kedua yang juga ditagihkan. Creative lead meninjau log submit taskId final sebelum dispatcher diizinkan untuk meng-commit, sebuah pemeriksaan satu menit yang mencegah typo prompt yang mahal.

Polling, error, dan idempotensi

Satu dispatcher mem-poll task setiap 5 detik dengan backoff hingga 30 detik, batas atas 100 percobaan (sekitar 8 menit). Kegagalan terminal (failed, error) memicu satu retry dengan Idempotency-Key baru hanya jika deskripsi kegagalan mengindikasikan masalah backend sementara. Error referensi atau prompt ditampilkan ke creative lead dan diperbaiki sebelum submit ulang, tidak di-retry secara buta. Dispatcher menulis satu baris log terstruktur per percobaan (task ID, status, progress, detik berlalu) agar biaya dan latensi dapat diaudit setelah peluncuran.

Edit region

Saat review, klien meminta untuk menukar produk di rak kanan shot final. Tim mengirimkan task edit level region yang hanya menargetkan area tersebut, mempertahankan gerak dan identitas sisanya. Ini adalah fitur 2.5 yang paling bernilai untuk pekerjaan klien: round-trip satu hari berubah menjadi regenerasi 10 menit. Pipeline menyimpan taskId asli dan taskId edit yang tertaut di log proyek, agar silsilah setiap frame yang dirilis dapat ditelusuri.

Delivery

videoUrl yang sudah ready diunduh, ditranscode ke H.264 dengan fast-start untuk autoplay web, dipasangkan dengan poster WebP yang diekstrak dari coverUrl, dan diunggah ke CDN tim. Aset final dimasukkan ke landing page dan ditinjau frame-by-frame (identitas, tangan, geometri produk, logo, sinkronisasi audio) sebelum dipublikasikan.

Disiplin biaya

Pipeline membatasi pengeluaran di tiga titik. Pertama, run iterasi terjadi di Fast alih-alih 2.5. Kedua, pre-check kredit sebelum setiap submit 2.5 membatalkan jika saldo dompet di bawah ambang batas untuk durasi dan resolusi yang dipilih. Ketiga, anggaran task per peluncuran yang mengeras di dispatcher menolak submit task baru setelah tercapai. Harga Seedance 2.5 belum dipublikasikan, jadi tim memperlakukan angka per detik apa pun sebagai estimasi dan membaca generator live untuk kredit terkini sebelum setiap kampanye.

Menangani 50 Referensi Multimodal

Fitur unggulan, hingga 50 input multimodal, muncul di payload sebagai array URL publik:

{
  "model": "seedance-2.5",
  "prompt": "Keep the character from the first image unchanged; use the video for body motion and the audio for rhythm",
  "duration": 20,
  "resolution": "1080p",
  "aspect_ratio": "16:9",
  "reference_images": ["https://cdn.example.com/character.jpg", "https://cdn.example.com/product.jpg"],
  "reference_videos": ["https://cdn.example.com/motion.mp4"],
  "generate_audio": true
}

Semua URL referensi harus dapat dijangkau publik. Beri setiap referensi satu peran dan jelaskan peran tersebut di prompt ("use @Video 1 only for body motion"), agar model tahu input mana yang mengendalikan properti mana.

Catatan developer: Pre-validasi bahwa setiap URL referensi mengembalikan HTTP 200 dengan content-type yang diharapkan sebelum submit. Satu 403 pada aset terlindungi CDN adalah penyebab paling umum dari task failed di production, dan membuang satu anggaran generasi penuh. Pemeriksaan HEAD request dua baris di klien Anda mencegah seluruh kelas kegagalan ini. Gunakan juga URL stabil yang berbasis konten (misalnya dengan hash atau versi di path), agar mengganti aset di tengah kampanye tidak diam-diam mengubah apa yang diterima model.

Penanganan Error dan Idempotensi

• 401 "API Key 无效", kunci salah, atau kunci tidak punya scope video. Periksa kunci dan permission-nya.
• 400 "模型不存在或未配置", rute seedance-2.5 belum diaktifkan di backend ini. Di PixMind ini adalah status Coming Soon.
• 4001 "余额不足", permintaan valid tetapi dompet Anda tidak punya kredit; task tidak dibuat.
• 429 rate limit, lakukan backoff eksponensial dan retry; endpoint create menerapkan batas konkurensi per kunci dan batas rate request. Jika Anda sering menemui ini, hubungi support untuk menaikkan batas atau renggangkan submit dalam interval pendek.
• 502 / 504 gateway, sementara; retry panggilan create dengan Idempotency-Key yang sama agar backend melakukan deduplikasi dan Anda tidak memulai task kedua yang juga ditagihkan.
• Polling timeout, batasi percobaan (misalnya 100 × 5 detik, sekitar 8 menit) dan perlakukan timeout sebagai kegagalan dengan satu retry.

Untuk production, sertakan header Idempotency-Key pada setiap panggilan create agar retry klien tidak memulai task kedua yang juga ditagihkan. Gunakan UUID per task logis (bukan per percobaan HTTP), dibuat sekali dan disimpan di sisi Anda, agar task logis yang sama ter-deduplikasi lintas retry, CI rerun, dan queue replay. Polanya: buat UUID ketika pengguna (atau job runner) memutuskan untuk membuat task, simpan sebelum panggilan HTTP pertama, dan gunakan kembali untuk setiap retry task logis tersebut.

Resource Developer Pihak Ketiga

Kontrak di atas adalah jalur implementasi di PixMind. Untuk konteks lebih dalam tentang model underlying ByteDance dan permukaan API resmi, berikut adalah resource yang paling sering dicari developer, diverifikasi 2026-07-31:

• Halaman resource BytePlus Seedance 2.5, ai.byteplus.com/lumina/en/resource/bytedance-seedance-2-5. Pandangan ByteDance sendiri tentang 2.5, berorientasi pada generasi video iklan dan demo produk. Berguna untuk narasi kapabilitas dan use case yang ByteDance sendiri targetkan. Listing terverifikasi, 2026-07-31.
• Dokumentasi API BytePlus ModelArk, permukaan developer resmi untuk memanggil Seedance melalui cloud ByteDance. Silang-referensikan nama field dan mode ketika Anda perlu mengonfirmasi apa yang diekspos oleh rute yang terhubung, lalu cermin nama tersebut di klien Anda.
• Dokumentasi Volcengine 火山方舟 (Volcano Engine Ark), volcengine.com/docs/82379. Endpoint domestik (Tiongkok) untuk keluarga model yang sama. Pola submit-dan-poll asinkron sama seperti rute PixMind; nama field dan alur autentikasi sedikit berbeda. Listing terverifikasi, 2026-07-31; konfirmasikan path live sebelum integrasi.
• Panduan rekreasi demo MakeFun AI, makefun.ai/seedance-2-5-demo-videos/. Membahas cara membuat ulang workflow demo yang kaya referensi dari BytePlus ModelArk. Berguna ketika Anda ingin mereproduksi tampilan resmi sebelum merancang prompt Anda sendiri.
• Analisis komunitas, uraiannya Topview/Medium tentang 2.5, liputan FORCE dari Pixo, dan panduan lengkap ToSea semuanya membahas peningkatan workflow dari sudut pandang editorial. Berguna untuk konteks, bukan untuk detail endpoint; selalu konfirmasikan spesifikasi teknis terhadap API live.

Catatan developer: Panduan pihak ketiga cepat usang. Perlakukan salah satunya sebagai titik awal dan konfirmasikan path endpoint, nama field, dan biaya kredit terhadap rute yang terhubung pada hari Anda mengintegrasikan. Detail endpoint dan autentikasi panduan ini diverifikasi per 2026-07-31, tetapi model masih dalam peluncuran bertahap, jadi periksa ulang sebelum rilis production.

FAQ API Seedance 2.5

Apa endpoint API Seedance 2.5?

Buat task dengan POST /api-platform/v1/generations, lalu poll GET /api-platform/v1/task/{task_id} hingga status bernilai ready. Field model adalah seedance-2.5.

Bagaimana cara mengautentikasi ke API Seedance 2.5?

Kirim API key Anda sebagai Authorization: Bearer <key>. Header X-API-Key juga diterima. Buat kunci dengan permission video di dashboard PixMind dan muat dari environment variable, bukan menanamnya di source code.

Apakah API Seedance 2.5 tersedia di PixMind?

Rute sudah didokumentasikan dan siap; akses backend sedang difinalisasi dan model ditandai Coming Soon. Halaman /api-platform/models/seedance-2-5 memiliki referensi endpoint dan parameter, dan halaman /ai-video/seedance-2-5 meng-host generator web sementara itu.

Berapa banyak referensi yang bisa saya kirim dalam satu request Seedance 2.5?

Hingga 50 input multimodal, gabungan gambar, video, teks, dan audio, dalam satu request. Naik dari 9 di Seedance 2.0. Setiap referensi harus berupa URL yang dapat dijangkau publik.

Apakah API Seedance 2.5 mengembalikan video secara sinkron?

Tidak. Generasi video bersifat asinkron. Panggilan create mengembalikan taskId; Anda mem-poll endpoint task hingga status bernilai ready, lalu baca videoUrl. Generasi 30 detik tipikal memakan waktu beberapa menit, jadi rancang klien Anda untuk polling, bukan untuk blocking.

Apa saja rate limit dan batas konkurensi?

Endpoint create menerapkan batas rate request dan konkurensi per kunci. Jika Anda melampauinya, respon mengembalikan 429 dan Anda harus melakukan backoff eksponensial. Untuk workload batch (lebih dari segelintir task konkuren), renggangkan submit dalam interval pendek dan hubungi support untuk menaikkan batas jika Anda sering menemui 429. Nilai batas persis disesuaikan per akun, jadi verifikasi pada kunci Anda sendiri sebelum merancang pekerjaan batch besar.

Apakah API Seedance 2.5 mendukung webhook atau callback?

Rute PixMind yang terverifikasi hanya menggunakan polling berbasis poll, bukan push callback. Jika arsitektur Anda butuh push notification, jalankan satu dispatcher yang mem-poll endpoint task dan memancarkan webhook ke layanan downstream Anda saat status mencapai status terminal. Ini menjaga integrasi tetap sederhana dan menghindari keterikatan pipeline Anda ke URL callback yang mungkin berubah antar environment.

Berapa banyak task konkuren yang bisa saya jalankan?

Konkurensi dibatasi oleh batas per kunci dan oleh saldo kredit Anda. Untuk pekerjaan 30 detik 1080p, asumsikan menjalankan segelintir task paralel alih-alih puluhan. Perlakukan batas live sebagai terverifikasi-pada-akun-Anda: kirim batch kalibrasi kecil, ukur berapa banyak task yang bergerak dari pending ke processing secara bersamaan, dan sesuaikan ukuran antrean terhadap angka tersebut.

Format video apa yang dikembalikan API?

Task yang ready mengembalikan videoUrl yang menunjuk ke file MP4 standar, plus coverUrl untuk frame poster. Unduh dan transcode ke format yang dibutuhkan target delivery Anda (H.264 dengan fast-start untuk web, encoding vertikal untuk sosial, ProRes untuk mastering edit). Jangan hotlink videoUrl yang di-host API di production karena tidak dijamin persisten; salin file tersebut ke CDN Anda sendiri saat ready.

Bagaimana cara mengecek kredit sebelum submit?

Baca generator live untuk biaya kredit terkini pada durasi dan resolusi yang Anda pilih, lalu periksa saldo dompet Anda. API mengembalikan 4001 "余额不足" jika saldo terlalu rendah, dan task tidak dibuat. Untuk pipeline production, tambahkan pengecekan saldo pre-submit yang membatalkan lebih awal jika saldo di bawah ambang batas per task, agar Anda tidak mengantrekan pekerjaan yang tidak bisa ditutup dompet.

Bagaimana cara memperbaiki error "模型不存在或未配置"?

Respon 400 ini berarti rute seedance-2.5 belum diaktifkan di endpoint backend yang Anda tuju. Di PixMind ini adalah status Coming Soon selagi koneksi backend difinalisasi. Konfirmasikan Anda memanggil path /api-platform/v1/generations yang didokumentasikan dengan model: "seedance-2.5" (huruf kecil, persis). Jika keduanya sudah benar dan error tetap muncul, rute tersebut belum dibuka di akun Anda; pantau halaman /api-platform/models/seedance-2-5 untuk ketersediaan.

Resolusi dan durasi apa yang bisa saya request?

Durasi hingga 30 detik dalam satu shot; resolusi 480p, 720p, 1080p, dan 4K native. Konfirmasikan opsi persisnya di generator live sebelum submit, karena rute yang terhubung mungkin hanya mengekspos subset.

Apakah harga API Seedance 2.5 sudah dipublikasikan?

Belum. Perlakukan angka per detik yang Anda lihat di tempat lain sebagai estimasi. Baca generator live untuk kredit terkini pada durasi dan resolusi yang Anda pilih sebelum submit, dan susun pipeline Anda agar bisa menyerap pembaruan harga tanpa menulis ulang integrasi.

Mulai Membangun dengan API Seedance 2.5

API Seedance 2.5 adalah kontrak generasi video asinkron standar: satu panggilan create, satu loop poll, satu unduhan. Setelah Anda memiliki kunci dengan scope video, contoh curl dan Python di atas adalah semua yang Anda butuhkan untuk merilis integrasi pertama. Tabel perbandingan dan studi kasus pipeline memperlihatkan cara mengembangkan kontrak tersebut dari satu klip menjadi workflow produksi yang dapat diulang, yang bertahan terhadap edit klien, tekanan anggaran, dan tenggat.

→ Baca referensi rute API Seedance 2.5 secara lengkap, atau coba model di generator web selagi akses API sedang difinalisasi.

Bandingkan setiap rute Seedance

Detail endpoint dan autentikasi diverifikasi terhadap backend api-platform PixMind pada 2026-07-31. Link resource pihak ketiga diverifikasi 2026-07-31. Field perbandingan API Kling ditandai sebagai estimasi dan harus dikonfirmasi terhadap dokumentasi Kling live. Harga Seedance 2.5 belum dipublikasikan dan ditandai sebagai estimasi saja.