Seedance Genel API
Seedance video ve görsel üretim API'leri belgeleri.
Canlı erişim — E-postası doğrulanmış kullanıcılar Ayarlar → API Anahtarları bölümünde
sd_live_...Key oluşturabilir. API, PC ürünüyle aynı kredileri, fiyatları, görevleri ve başarısızlık iadelerini kullanır. Yeni self servis Key’ler sıkı istek düzeyi uyumluluk kontrolleriyle gerçek kişi modunu destekler.
Erişim noktaları
- Belgeler:
https://seedance2video.io/tr/docs/api - Hesap girişi:
/settings/public-api - Temel URL:
https://api.seedance2video.io/v1 - OpenAPI:
https://api.seedance2video.io/v1/openapi.json
OpenAPI URL'sini Postman, Insomnia, Bruno veya sunucu taraflı bir istemci oluşturucuyla kullanın. v1 tarayıcı CORS'unu etkinleştirmez; canlı bir Key'i asla ön uç JavaScript koduna koymayın.
Birinci aşama endpoint'leri
| Yetenek | Endpoint |
|---|---|
| Key için etkin modelleri listeleme | GET /models |
| Video oluşturma | POST /videos |
| Görsel oluşturma | POST /images |
| Üretim durumunu sorgulama | GET /generations/{id} |
| PC kredi bakiyesini okuma | GET /credits/balance |
| OpenAPI indirme | GET /openapi.json |
Yüklemeler, Webhook’lar, iptal, kullanım listesi, test Key’leri ve ayrı API cüzdanı birinci aşamada sunulmaz.
Sözleşme
Authorization: Bearer sd_live_...ile kimlik doğrulayın.- Her oluşturma isteğine kararlı bir
Idempotency-Keyekleyin. - Üretim eşzamansızdır; döndürülen
status_urladresini sorgulayın. - Tamamlanan URL'ler
output.urlsiçinde; kolaylık sağlayan tipli alanlar olarak daoutput.video_urlveyaoutput.image_urlsiçinde döner. - Medya girdileri, entegrasyonunuz için onaylanmış depolama host'larındaki genel HTTPS URL'leri olmalıdır. Base64,
data:URL'leri, localhost, düz IP adresleri ve rastgele uzak host'lar reddedilir. - Provider adları, Provider görev kimlikleri, ham Provider yanıtları ve dahili model kimlikleri asla döndürülmez.
Modeller
İzin listesi: seedance-2.0-pro, seedance-2.0-fast, seedance-2.0-mini, kling-3.0, gpt-image-2, nano-banana-2 ve nano-banana-pro.
Veo veya Lite modeli sunulmaz.
Gerçek kişi modu
Üretim yetkisi olan her Key, sıkı istek düzeyi uyumluluk kontrolleriyle gerçek kişi modunu istek başına seçebilir. Bu özellik, image-to-video veya multimodal-to-video modundaki üç Seedance modeliyle sınırlıdır. parameters.real_person_mode: true ayarlayın; ayrıca compliance.rights_confirmed: true ve compliance.consent_reference içinde müşteriye ait bir denetim referansı gönderin. Güvenlik kontrolleri sunucunun yönetiminde kalır.
Hızlı başlangıç ile başlayın; ardından Kimlik Doğrulama, Modeller ve Fiyatlandırma, Eşzamansız Üretimler, Hatalar ve İdempotensi ve n8n sayfalarını inceleyin.