API Publik Seedance

Dokumentasi API pembuatan video dan gambar Seedance.

Akses Live — Pengguna dengan email terverifikasi dapat membuat Key sd_live_... di Pengaturan → Kunci API. API memakai kredit, harga, tugas, dan pengembalian gagal yang sama dengan produk PC. Setiap Key mandiri dapat memilih mode orang nyata per permintaan dengan kontrol kepatuhan ketat.

Titik akses

Gunakan URL OpenAPI dengan Postman, Insomnia, Bruno, atau generator klien sisi server. v1 tidak mengaktifkan CORS browser; jangan pernah menaruh live key di JavaScript frontend.

Endpoint fase pertama

KemampuanEndpoint
Daftar model yang diizinkan untuk KeyGET /models
Membuat videoPOST /videos
Membuat gambarPOST /images
Memeriksa proses pembuatanGET /generations/{id}
Membaca saldo kredit PCGET /credits/balance
Mengunduh OpenAPIGET /openapi.json

Unggahan, Webhook, pembatalan, daftar penggunaan, test key, dan dompet API terpisah belum tersedia pada fase pertama.

Kontrak

  • Gunakan Authorization: Bearer sd_live_... untuk autentikasi.
  • Tambahkan Idempotency-Key yang stabil pada setiap permintaan pembuatan.
  • Pembuatan berjalan asinkron; periksa status_url yang dikembalikan.
  • URL hasil tersedia di output.urls, dengan output.video_url atau output.image_urls sebagai bidang bertipe yang praktis.
  • Input media harus berupa URL HTTPS publik pada host penyimpanan yang disetujui untuk integrasi Anda. Base64, URL data:, localhost, alamat IP literal, dan host jarak jauh sembarang akan ditolak.
  • Nama Provider, ID tugas Provider, respons mentah Provider, dan ID model internal tidak pernah dikembalikan.

Model

Daftar yang diizinkan adalah seedance-2.0-pro, seedance-2.0-fast, seedance-2.0-mini, kling-3.0, gpt-image-2, nano-banana-2, dan nano-banana-pro.

Tidak ada model Veo atau Lite yang tersedia.

Mode orang nyata

Setiap Key dengan izin pembuatan dapat memilih mode orang nyata per permintaan dengan kontrol kepatuhan ketat. Kemampuan ini terbatas pada tiga model Seedance dalam mode image-to-video atau multimodal-to-video. Atur parameters.real_person_mode: true, lalu sertakan compliance.rights_confirmed: true dan referensi audit pelanggan di compliance.consent_reference. Kontrol keamanan tetap dikelola server.

Mulai dari Panduan cepat, lalu baca Autentikasi, Model & Harga, Pembuatan Asinkron, Kesalahan & Idempotensi, dan n8n.