
Seedance 2.5 Flash API, Seedance 2.5 API'nin daha hızlı ve daha düşük maliyetli katmanıdır ve PoYo'da tek bir model kimliğidir: seedance-2.5-flash. ByteDance onu 12 Kasım 2026'da yayımladı; deneme alanı ve güncel fiyatlar Seedance 2.5 Flash model sayfasında bulunuyor. Bu rehber, 16 Kasım 2026'da kontrol edilen Seedance 2.5 Flash API belgelerindeki şemayı kullanarak sizi ilk cURL isteğinden Python'da üretime hazır bir döngüye kadar götürür.
Bir bakışta Seedance 2.5 Flash API
| Öğe | Değer |
|---|---|
| Gönderim uç noktası | POST https://api.poyo.ai/api/generate/submit |
| Durum uç noktası | GET https://api.poyo.ai/api/generate/status/{task_id} |
| Kimlik doğrulama başlığı | Authorization: Bearer $POYO_API_KEY |
| Model kimliği | seedance-2.5-flash (sayfa slug'ı olan seedance-2-5-flash bir model kimliği değildir) |
| Zorunlu alanlar | prompt, duration |
| Süre | Tam saniye, 4–30 |
| Çözünürlük | 480p veya 720p, varsayılan 720p |
| En-boy oranı | auto, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16, varsayılan auto |
| Ses | generate_audio, varsayılan true |
| Teslim | Asenkron görev: durumu yoklayın veya callback_url ayarlayın |
cURL ile ilk Seedance 2.5 API isteğiniz
Anahtarınızı POYO_API_KEY olarak dışa aktarın ve onu sunucuda tutun, asla tarayıcı kodunda değil. Bu, 5 saniyelik 480p bir metinden videoya isteğidir; 92,5 kredilik düşük maliyetli bir ilk test:
curl --fail-with-body https://api.poyo.ai/api/generate/submit \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-flash",
"input": {
"prompt": "A paper boat drifts under a stone bridge at sunrise. Slow tracking shot, gentle water sounds, no speech, no subtitles.",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "16:9"
}
}'
Başarılı bir gönderim code: 200 ve task_id, status (gönderimden hemen sonra her zaman not_started) ile created_time içeren bir data nesnesi döndürür. Bu bir makbuzdur, video değil. task_id değerini kaydedin, ardından sorgulayın:
curl --fail-with-body \
https://api.poyo.ai/api/generate/status/YOUR_TASK_ID \
-H "Authorization: Bearer $POYO_API_KEY"
Durumlar not_started, running, finished ve failed sırasıyla ilerler. Görev finished olduğunda video URL'si file_type: "video" ile data.files[].file_url içindedir; failed durumunda data.error_message alanını okuyun. Üretilen dosyalar 3 gün erişilebilir kalır, bu yüzden onları kendi depolama alanınıza kopyalayın.
Python: kesin bir süre sınırıyla gönderin ve yoklayın
Durum belgeleri, her 2–5 saniyede bir yoklamayı, 429 ve 5xx durumlarında beklemeyi artırmayı (backoff) ve her zaman bir zaman aşımı ayarlamayı önerir. Aşağıdaki döngü bu üçünü de yapar ve zaman aşımında asla yeniden göndermez, çünkü ikinci bir gönderim faturalandırılan ikinci bir görevdir.
import os
import time
import requests
BASE = "https://api.poyo.ai"
session = requests.Session()
session.headers["Authorization"] = "Bearer " + os.environ["POYO_API_KEY"]
def checked(response):
try:
body = response.json()
except ValueError:
response.raise_for_status()
raise
if body.get("code") != 200:
err = body.get("error") or {}
raise RuntimeError(
f"PoYo {body.get('code')} {err.get('type')}: "
f"{err.get('message') or body.get('detail')}"
)
return body["data"]
task = checked(session.post(BASE + "/api/generate/submit", json={
"model": "seedance-2.5-flash",
"input": {
"prompt": "A paper boat drifts under a stone bridge at sunrise. Slow tracking shot.",
"duration": 5,
"resolution": "480p",
"aspect_ratio": "16:9",
},
}, timeout=60))
task_id = task["task_id"]
print("Saved task:", task_id, flush=True)
deadline = time.monotonic() + 15 * 60
backoff = 5
while time.monotonic() < deadline:
r = session.get(f"{BASE}/api/generate/status/{task_id}", timeout=60)
if r.status_code == 429 or r.status_code >= 500:
time.sleep(backoff)
backoff = min(backoff * 2, 60)
continue
data = checked(r)
if data["status"] == "failed":
raise RuntimeError(data.get("error_message") or "Generation failed")
if data["status"] == "finished":
videos = [f["file_url"] for f in data.get("files", [])
if f.get("file_type") == "video"]
print(videos[0], "credits:", data.get("credits_amount"))
break
backoff = 5
time.sleep(5)
else:
raise TimeoutError("Still running; poll the saved task ID later: " + task_id)
Fikir vermesi için: PoYo'nun 16 Kasım 2026'daki testlerinde 4 saniyelik 480p bir klip uçtan uca yaklaşık iki dakikada, 30 saniyelik 720p bir klip ise üç dakikanın altında tamamlandı. Süreler yüke göre değişir; bu yüzden 15 dakikalık süre sınırı bir tahmin değil, bir güvenlik sınırıdır.
Yoklamayı atlayın: callback_url kullanın
model alanının yanına üst düzey bir callback_url ekleyin. Görev finished veya failed olduğunda PoYo, gövdesi code/data sarmalayıcısı olmadan görev veri nesnesi (task_id, status, files, created_time, error_message) olan bir POST gönderir. Video webhook belgelerine göre:
- URL herkese açık HTTPS olmalı, en fazla 2048 karakter uzunluğunda olmalı ve özel IP içermemelidir.
- 30 saniye içinde 2xx ile yanıt verin; başarısız teslimatlar üstel bekleme (exponential backoff) ile en fazla 5 kez yeniden denenir.
X-Webhook-Signaturedeğerinibase64(HMAC-SHA256(task_id + "." + timestamp, key))olarak doğrulayın;timestampdeğeriX-Webhook-Timestampbaşlığından, anahtar iseGET /api/api-keys/webhook-secretüzerinden alınır.- İşleyiciyi idempotent yapın. Tüm yeniden denemeler başarısız olursa sonuç durum uç noktasında yine de bulunur.
JSON gövdeleriyle üç girdi modu
API, modu gönderdiğiniz medyaya göre seçer. mode diye bir alan yoktur.
| Mod | Ne zaman seçilir | En-boy oranı |
|---|---|---|
| Referanstan videoya | reference_image_urls, reference_video_urls, reference_audio_urls alanlarından herhangi biri boş değilse | Desteklenen herhangi bir değer |
| Görselden videoya (ilk/son kare) | image_urls boş değilse | auto veya hiç gönderilmez; çıktı ilk kareyi izler |
| Metinden videoya | Medya yoksa | Desteklenen herhangi bir değer |
image_urls ve referans alanları ayrı isteklerde gönderilir. Bu gövdeler belgelerdeki örneklerdir.
Metinden videoya (720p'de 30 saniye, istemde zamanlanmış bir çekim listesiyle):
{
"model": "seedance-2.5-flash",
"callback_url": "https://your-domain.com/callback",
"input": {
"prompt": "One continuous 30-second story of the same young woman in a yellow raincoat delivering a handwritten letter across a small seaside town at dawn. 0-6s: wide aerial shot of the sleepy harbor town, fishing boats rocking, soft morning light; she rides an old bicycle down a cobblestone hill. 6-12s: tracking shot beside her as she weaves past a fish market, seagulls lifting off, a vendor waves at her. 12-18s: low-angle shot as she climbs a steep stone staircase carrying the bicycle, breathing hard, the letter tucked in her pocket. 18-24s: she knocks on a blue door at the top; an elderly man opens it and she hands him the letter. 24-30s: close-up of the man reading, his eyes filling with tears; he smiles and says softly, \"She remembered.\" Camera slowly pulls back to reveal the sunrise over the sea. Natural ambient sound: waves, gulls, bicycle bell, footsteps, gentle piano music. No subtitles, no on-screen text.",
"duration": 30,
"resolution": "720p",
"aspect_ratio": "16:9",
"generate_audio": true
}
}
İlk ve son kare (bir URL açılışı, ikincisi bitişi sabitler):
{
"model": "seedance-2.5-flash",
"input": {
"prompt": "Locked-off time-lapse of the red lakeside cabin: start from the summer evening in the first frame, let snow gradually cover the shore and the wooden dock as the sky darkens, and end exactly on the snowy night with the aurora in the last frame. Soft wind and crackling ice.",
"image_urls": [
"https://example.com/first-frame.jpg",
"https://example.com/last-frame.jpg"
],
"duration": 5,
"resolution": "720p",
"aspect_ratio": "auto"
}
}
Referanstan videoya (dosyalara yükleme sırasına göre @Image1, @Video1, @Audio1 şeklinde başvurun):
{
"model": "seedance-2.5-flash",
"input": {
"prompt": "@Image1 is the ginger cat. It wears the yellow knitted scarf from @Image2 and is inside the bookstore from @Image3. On a rainy night the cat walks along a bookshelf, jumps down beside a reading lamp, and looks at the camera. Match the slow, cozy rhythm of @Audio1. No subtitles.",
"reference_image_urls": [
"https://example.com/cat.png",
"https://example.com/scarf.png",
"https://example.com/bookstore.png"
],
"reference_audio_urls": [
"https://example.com/rhythm.mp3"
],
"duration": 6,
"resolution": "480p",
"aspect_ratio": "16:9"
}
}
Göndermeden önce uygulanacak doğrulama kuralları
Bunları istemci tarafında kontrol etmek bir gidiş-dönüşü önler ve kullanıcılarınıza genel bir 400 hatasından daha açık bir mesaj verir.
| Alan | Kural |
|---|---|
prompt | Zorunlu, boş olmayan dize |
duration | Zorunlu tamsayı, 4–30 |
resolution | Yalnızca 480p veya 720p; 1080p için seedance-2.5 gerekir |
aspect_ratio | Yedi değerden biri; image_urls ile auto kullanın veya hiç göndermeyin |
image_urls | 1–2 URL (önce ilk, sonra son kare); JPEG, PNG veya WebP, her biri en fazla 30 MB; referans alanlarıyla birlikte kullanılmaz |
reference_image_urls | En fazla 10; JPEG, PNG veya WebP, her biri en fazla 30 MB |
reference_video_urls | En fazla 5; MP4 veya MOV, her biri 2–30 sn ve en fazla 200 MB; toplam uzunluk en fazla 30 sn |
reference_audio_urls | En fazla 5; MP3 veya WAV, her biri 2–30 sn ve en fazla 15 MB; toplam uzunluk en fazla 30 sn; bir referans görsel veya video gerektirir |
| Tüm medya URL'leri | Herkese açık HTTP veya HTTPS, doğrudan indirilebilir (giriş sayfası veya süresi dolan önizleme olmamalı) |
Toplam referans süreleri görev gönderildiğinde kontrol edilir. Şema ayrıca input üzerinde additionalProperties: false ayarlar; bu yüzden diğer sağlayıcıların API'lerinden seed veya negative_prompt gibi alanlar göndermeyin.
Ele alınmaya değer hatalar
Gövdedeki code alanını her zaman okuyun: gönderim uç noktasından gelen bazı doğrulama hataları HTTP 200 ve "code": 400 ile döner. Hata kodu referansı bunları listeler:
| Kod | Tür | Ne yapmalı |
|---|---|---|
400 | validation_error, file_format_error, content_moderation_error | İsteği veya medyayı düzeltin; değiştirmeden yeniden denemeyin |
401 | authentication_error | Bearer başlığını ve anahtarın hâlâ var olduğunu kontrol edin |
402 | insufficient_credits_error | Bakiye yükleyin, ardından yeniden gönderin |
429 | Hız sınırı | Yeniden yoklamadan veya göndermeden önce bekleme süresini artırın (1 sn, 2 sn, 4 sn...) |
500, 502, 503 | Sunucu veya üst sağlayıcı | Durum çağrısını backoff ile yeniden deneyin; yeniden göndermeden önce durumu kontrol edin |
Görev failed | error_message ayarlanmış | Görev kimliğini kaydedin; başarısız görevler credits_amount: 0 bildirir |
İlk fatura nasıl hesaplanır
Referans video olmadan maliyet, çıktı saniyesi ile saniye başına ücretin çarpımıdır: 480p'de 18,5 kredi ($0,0925), 720p'de 41 kredi ($0,205); 1 kredi = $0,005. Üretilen ses ek ücret getirmez.
| Yukarıdaki istek | Faturalandırılan saniye | Kredi | USD |
|---|---|---|---|
| cURL testi, 5 sn 480p | 5 | 92.5 | $0.4625 |
| Metinden videoya, 30 sn 720p | 30 | 1,230 | $6.15 |
| İlk/son kare, 5 sn 720p | 5 | 205 | $1.025 |
| Referans görseller + ses, 6 sn 480p | 6 | 111 | $0.555 |
Herhangi bir reference_video_urls eklemek, faturalandırılan saniyelere uygulanan daha düşük videolu ücrete (480p'de 11,5 kredi, 720p'de 25,5 kredi) geçirir: faturalandırılan saniye, çıktı süresi ile her referans videonun aşağı yuvarlanmış tam saniye uzunluğunun toplamıdır. Seedance 2.5 API fiyatlandırma dökümü bu durumları adım adım hesaplar. Tamamlanmış bir görevin ücreti durum yanıtında credits_amount olarak görünür.
1080p için Seedance 2.5'e geçin
İstek alanları aynı olduğundan, bir işi Flash'tan standart Seedance 2.5 modeline taşımak yalnızca model kimliği değişikliğidir:
{
"model": "seedance-2.5",
"input": {
"prompt": "A paper boat drifts under a stone bridge at sunrise. Slow tracking shot.",
"duration": 5,
"resolution": "1080p",
"aspect_ratio": "16:9"
}
}
İki ayrıntı: seedance-2.5 belgeleri resolution alanını zorunlu olarak listeler, bu yüzden onu her zaman gönderin; standart model ise en fazla 30 görsel, 10 video ve 10 ses referansına izin verir. 1080p'de saniye başına 114 kredi ($0,57) tutar. Yönlendirme kararı için Seedance 2.5 Flash ve Seedance 2.5 karşılaştırmasına, Seedance 2.5'in başka bir sağlayıcıyla karşılaştırması için Kling 4.0 ve Seedance 2.5 karşılaştırmasına bakın.
Sıkça sorulan sorular
Seedance 2.5 Flash API'nin model kimliği nedir? Noktalı olarak seedance-2.5-flash. Tireli seedance-2-5-flash yalnızca model sayfasının slug'ıdır.
Seedance 2.5 Flash API 1080p destekliyor mu? Hayır. 480p ve 720p kabul eder. Yerel 1080p için aynı gövdeyi "model": "seedance-2.5" ve "resolution": "1080p" ile gönderin.
Seedance 2.5 API'de sesi nasıl kapatırım? Sessiz bir klip için "generate_audio": false ayarlayın ya da sesi açık tutup istemde "no background music" gibi ifadelerle tek tek katmanları çıkarın.
Tek bir Seedance 2.5 Flash isteğinde ilk kareleri ve referans görselleri birlikte kullanabilir miyim? Hayır. image_urls ve reference_* alanları ayrı isteklerde gönderilmelidir.
Bir Seedance 2.5 Flash API görevi ne kadar sürer? PoYo'nun 16 Kasım 2026 testinde uçtan uca 480p'de 4 saniye için yaklaşık iki dakika, 720p'de 30 saniye için üç dakikanın altında. Bir isteği açık tutmak yerine yoklama yapın veya callback kullanın.
Bir Seedance 2.5 Flash görevi başarısız olursa ücret alınır mı? Hayır. Başarısız görevler ücretlendirilmez ve durumlarında credits_amount: 0 görünür.