doubao-seedance-2-5-flash modelini POST /ai/v1/videos ile kullanın, görevi sorgulayın ve ardından sonucu indirin. Güncel AIHubMix şeması 480p/720p çıktı, 4–30 saniyelik klipler ve en fazla 10 görsel, 5 video ve 5 ses referansı sunuyor. /v1/videos kullanan eski istemcilerin model kimliğinin yanı sıra uç noktayı da değiştirmesi gerekiyor.
Bu kılavuz 16 Kasım 2026'da kontrol edildi. Yukarıdaki kısa kimlik ve doubao-seedance-2-5-flash-261115 bir model şeması döndürdü ve 1080p isteğini 400 schema_violation hatasıyla reddetti. Ayrı bir 4 saniyelik 480p oluşturma denemesi 402 insufficient_quota hatası döndürdü; video oluşturulmadı. Aşağıdaki iş akışı mevcut şema ve belgeleri temel alıyor; ancak bu kontrolde başarılı oluşturma, gecikme, MOV çıktısı ve düzenleme uçtan uca doğrulanmadı.
Ön koşullar ve şema keşfi
Seedance 2.5 Flash model sayfasında model, bu kılavuz boyunca kullanılan kısa kimliğiyle listeleniyor. Bir görev göndermeden önce:
- AIHubMix konsolunda asenkron medya görevlerini etkinleştirin. Bu özellik etkin olmayan bir hesap için belgelenen hata
403 async_not_enabledşeklindedir. - API anahtarının erişimi olduğundan ve hesap bakiyesinin yeterli olduğundan emin olun. Canlı kontrolde
402 insufficient_quotahatası veYour account has insufficient quota. Add credits and try again.mesajı döndü. - Kabuk ortamınızda
AIHUBMIX_API_KEYdeğişkenini dışa aktarın. Anahtarı kaynak dosyalarında ve tarayıcı kodunda bulundurmayın. - Mevcut şemayı alın; şema keşif isteği kimlik doğrulaması gerektirmez.
curl --fail-with-body -sS \
'https://aihubmix.com/call/schema/models/doubao-seedance-2-5-flash/endpoints' \
| jq '.endpoints[] | select(.path == "/ai/v1/videos") | .request.schema'
16 Kasım tarihli şemada Flash için yalnızca /ai/v1/videos listeleniyor. Şema, resolution için 480p ve 720p değerlerini (varsayılan 720p), 4 ile 30 arasında bir tam sayı olarak duration değerini veya modelin süreyi seçmesi için -1 değerini kabul ediyor. Öngörülebilir bir bütçe gerektiğinde süreyi açıkça belirtin.
Oluşturma, sorgulama ve indirme
AIHubMix Video Oluşturma API'si, oluşturma, durum sorgulama ve indirme işlemlerini birbirinden ayırır. Oluşturma isteğinden alınan HTTP başarı yanıtı görevin kabul edildiği anlamına gelir; tamamlandığını yalnızca status: "completed" doğrular. Sorgu HTTP 200 döndürse bile görevin durumu status: "failed" olabilir.
Metinden videoya görev gönderme
Bu örnek, sesli, 10 saniyelik ve 720p çözünürlüklü 16:9 ürün klibi ister. Yalnızca metin kullandığı için başka bir yerde barındırılan referans görsellere bağlı değildir.
curl --fail-with-body -sS -X POST https://aihubmix.com/ai/v1/videos \
-H "Authorization: Bearer $AIHUBMIX_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "doubao-seedance-2-5-flash",
"prompt": "A matte ceramic espresso cup sits on wet slate as warm morning light sweeps across rising steam. The camera slowly dollies in. Quiet cafe ambience.",
"duration": 10,
"aspect_ratio": "16:9",
"resolution": "720p",
"generate_audio": true
}'
Dönen görev id değerini hemen kaydedin. GET /ai/v1/videos/{id} adresini her 15 saniyede bir sorgulayarak completed, failed veya cancelled durumuna ulaşmasını bekleyin. Aktif sorgulama için video ayrıntıları rotasını kullanın: bu rota sağlayıcı durumunu yeniler; birleşik görev listesi bu kontrolün yerini tutmaz. Tamamlandıktan sonra aynı Bearer başlığını kullanarak GET /ai/v1/videos/{id}/content üzerinden indirin.
Eksiksiz bir Python istemcisi
python3 -m pip install requests komutuyla bağımlılığı yükleyin, aşağıdakini seedance_flash.py adıyla kaydedin ve API anahtarınızın bulunduğu kabukta python3 seedance_flash.py komutunu çalıştırın. Bu örnek belgelenen iş akışını uygular; yukarıdaki kota hatası nedeniyle oluşturma işlemi baştan sona test edilemedi.
import os
import time
from pathlib import Path
import requests
BASE_URL = "https://aihubmix.com"
HEADERS = {
"Authorization": f"Bearer {os.environ['AIHUBMIX_API_KEY']}",
"Content-Type": "application/json",
}
PAYLOAD = {
"model": "doubao-seedance-2-5-flash",
"prompt": "A matte ceramic espresso cup sits on wet slate as warm morning light sweeps across rising steam. The camera slowly dollies in. Quiet cafe ambience.",
"duration": 10,
"aspect_ratio": "16:9",
"resolution": "720p",
"generate_audio": True,
}
# Submit once. A network timeout does not prove that creation failed.
response = requests.post(
f"{BASE_URL}/ai/v1/videos", headers=HEADERS, json=PAYLOAD, timeout=60
)
response.raise_for_status()
task = response.json()
task_id = task["id"]
print(f"Task ID: {task_id}", flush=True)
deadline = time.monotonic() + 20 * 60
while task["status"] not in {"completed", "failed", "cancelled"}:
if time.monotonic() >= deadline:
raise TimeoutError(f"Still waiting for {task_id}; query it again, do not recreate it.")
time.sleep(15)
response = requests.get(
f"{BASE_URL}/ai/v1/videos/{task_id}", headers=HEADERS, timeout=30
)
response.raise_for_status()
task = response.json()
if task["status"] != "completed":
raise RuntimeError(f"Task {task_id}: {task.get('error') or task['status']}")
response = requests.get(
f"{BASE_URL}/ai/v1/videos/{task_id}/content", headers=HEADERS, timeout=120
)
response.raise_for_status()
Path("seedance_flash_10s.mp4").write_bytes(response.content)
print("Saved seedance_flash_10s.mp4")
20 dakikalık süre sınırı, istemci tarafındaki bekleme sınırıdır; sunucuda iptal anlamına gelmez ve oluşturma süresini garanti etmez. Sorgulama veya indirme başarısız olursa görev kimliğini saklayıp ilgili işlemi yeniden deneyin. Zaman aşımından veya sağlayıcı durumunun belirsiz olmasından sonra otomatik olarak yeni bir oluşturma isteği göndermeyin.
BytePlus'ın resmî çevrimiçi çıkarım ücretlerine göre Flash, video girdisi olmadan milyon token başına $7.00; 480p/720p video girdisiyle $4.30 tutarındadır. Metin tabanlı örneğin tahmini token sayısı 10 × 1280 × 720 × 24 / 1024 = 216,000: 720p'de Flash için $1.51, amiral gemisi 2.5 içinse $2.31. Bunlar BytePlus üzerinden hesaplanan tahminlerdir; ölçülmüş AIHubMix faturası değildir.
Referanslar ve web kancaları
Bir klibe medya ile yön vermek için input_references listesine type (image_url, video_url veya audio_url) ve erişilebilir medya dosyanıza işaret eden bir url içeren girdiler ekleyin. Şemada bu türler sırasıyla en fazla 10 / 5 / 5 öğeyle sınırlandırılmıştır. İlk/son kare kontrolü için bunun yerine frame_images kullanın; her girdide bir frame_type ve iç içe bir image_url.url bulunur. Boş olmayan frame_images ve input_references listelerini birlikte kullanmayın. Kare iş akışlarında aspect_ratio: "adaptive" gerekir; son kare için ilk kare de gereklidir.
Asenkron Görevler belgeleri, webhook_url üzerinden HTTPS geri çağrılarını açıklar. Flash'ın mevcut şeması bu alanı içeriyor ancak webhook_events_filter alanını içermiyor ve additionalProperties: false olarak ayarlanmış; bu nedenle bu model şemasını izlerken filtre alanını eklemeyin. Belgelenen varsayılan ayar completed, failed ve cancelled durumlarında bildirim gönderir. Teslimat en az bir kez yapılır; en fazla altı deneme ve 1, 4, 16, 64 ve 256 saniyelik yeniden deneme aralıkları uygulanır. Yinelenen bildirimleri event_id ile ayıklayın. Görev düzeyindeki geri çağrılar için ayrı bir imzalama gizli anahtarı yoktur; bu nedenle son durumu doğrulamak için görevi sorgulayın. Belgeler, imza doğrulaması gereken uygulamalar için hesap düzeyinde abonelikleri açıklar.
Hatalar: ölçülenler ve belgelerde açıklananlar
1080p: şemanın ölçülmüş bir reddi
Her iki AIHubMix model kimliği de resolution: "1080p" içeren 4 saniyelik bir isteğe HTTP 400 döndürdü. Dönen hata alanları şunlardı:
{
"error": {
"code": "schema_violation",
"message": "`resolution` must be one of: 480p, 720p, null.",
"type": "invalid_request_error"
}
}
Yanıtta bir istek izleme kimliği de vardı; burada yer verilmemiştir. Bu, gözlemlenmiş bir ağ geçidi reddidir; çıkarımla ulaşılan bir üst akış hatası değildir. Başarılı video oluşturulduğunu da hızın ölçüldüğünü de göstermez.
Aşağıdaki diğer kısıtlamalar mevcut Flash şemasından alınmıştır; bu geçersiz birleşimler canlı kontrolde ayrıca gönderilmemiştir.
| Girdi sorunu | Şema gereksinimi | Çözüm |
|---|---|---|
| 4K çıktı | 480p veya 720p | Çözünürlüğü düşürün |
| Çok fazla referans | 10 görsel / 5 video / 5 ses | Öğe sayısını azaltın |
| İki referans listesi | Boş olmayan tek liste | Bir iş akışı seçin |
| Tek başına son kare | İlk kare de gerekli | Her iki kareyi de sağlayın |
| Karelerle sabit oran | Uyarlanabilir oran | Uyarlanabilir oranı kullanın |
Gerçek kişi referansları: doğrulanmış varlıkları kullanın
AIHubMix, Doubao gerçek kişiye ait bir görsel için özel gizlilik reddi döndürdüğünde doubao_real_person_required hatasını belgeler. Bu kontrol sırasında bu hata tetiklenmedi. Belgelenen mesaj şöyledir:
Bu istekte gerçek bir kişinin görseli kullanılıyor. Gerçek kişi doğrulamasını tamamlayın ve etkin bir varlık referansı kullanın. https://docs.aihubmix.com/cn/api/doubao-real-person-assets adresine bakın.
Doubao Gerçek Kişi Varlıkları Kılavuzu'nu izleyin: /ai/v1/asset-groups adresinde bir grup oluşturun, /ai/v1/asset-groups/{id}/verification-sessions adresinde bir doğrulama oturumu oluşturun, görseldeki kişinin web üzerinden doğrulamayı tamamlamasını sağlayın, /ai/v1/asset-groups/{id}/assets adresinde varlığı kaydedin ve etkinleşmesini bekleyin. Oluşturma referansında asset://<ASSET_ID> kullanın. Doğrudan bir fotoğraf URL'si, onay ve varlık iş akışının yerini tutmaz.
Kota, istek boyutu ve indirmeler
Ölçülen 402 insufficient_quota hatası, geçerli çözünürlükteki isteğin oluşturma aşamasına ulaşmasını engelledi. Yeniden denemeden önce hesaba kredi yükleyin; doğru bir prompt'u veya model kimliğini değiştirmek bu hatayı çözmez. 403 async_not_enabled farklı bir hatadır; belgelenen bir ön koşul olarak konsoldan etkinleştirme gerektirir.
AIHubMix, 32 MiB istek gövdesi sınırını ve 413 request_too_large hatasını belgeler. Herkese açık URL'ler, Base64 kodlamasının isteğin gövdesini büyütmesini önler; ancak referans verilen medyanın yine de modelin kendi boyut ve biçim sınırlarını karşılaması gerekir.
Tamamlanmış videoyu gecikmeden kaydedin. AIHubMix'in Seedance 2.5 için mevcut entegrasyon kılavuzu, çıktı URL'lerinin kısa süreli olduğunu ve yaklaşık 30 dakika geçerli kaldığını belirtiyor; Flash için sabit bir saklama süresi burada doğrulanmadı. Video API'si expires_at: null döndürebilir; bu, verilerin süresiz saklanacağını garanti etmez. Belgelenen indirme hataları arasında 410 artifact_expired ve 429 too_many_downloads bulunur. İndirmede geçici bir hizmet hatası olursa klibi yeniden oluşturmak yerine mevcut görevin indirme işlemini tekrar deneyin.
Geçerli bir istekte bile karşılaşılabilecek geçiş tuzakları
Volcengine'in Seedance 2.5 kılavuzu, Flash'ı açıkça model ailesine dahil ediyor ve MOV çıktısını, düzenlemeyi ve uzatmayı doğruluyor. Ancak bu sağlayıcı özelliklerini, ağ geçidi üzerinden doğrulanmış olanlardan ayrı değerlendirmek gerekir.
- MOV ve düzenleme alanları sunuluyor ancak uçtan uca test edilmedi. Flash'ın şeması
extra.output_format: "mp4"veya"mov"değerlerini veextra.omni_reference_task_typeiçinauto,reference,editveextendseçeneklerini kabul ediyor. Görev türü alanını açıkça gönderirseniz şema boş olmayan birinput_referenceslistesi gerektirir.editiçin ayrıca bir video referansı, uyarlanabilir oran veduration: -1gerekir;extendiçinse bir video referansı ve uyarlanabilir oran gerekir. - Görev türünü açıkça belirtmek, modelin bunu kabul edeceği anlamına gelmez. Ark, çıkarımla belirlenen görev türü ile parametreler çakıştığında asenkron
InvalidParameter.TaskTypeConstraint; çıkarımla belirlenen tür açıkça istenen türden farklı olduğunda iseInvalidParameter.TaskTypeMismatchhatasını belgeliyor. AIHubMix'teki kesin eşleştirme ölçülmedi; tek bir ağ geçidi hata kodunu varsaymak yerine dönen görevinerroralanını inceleyin. - Flash'ta Draft aşamasından yükseltme yok. Sağlayıcı, 480p Draft'tan nihai çıktıya uzanan iki aşamalı iş akışını yalnızca amiral gemisi 2.5 ile sınırlandırıyor. Flash bu özelliği desteklemiyor; ayrıca her iki model için mevcut AIHubMix şemalarında da
draftvedraft_taskalanları bulunmuyor. - Video girdisi ücretlendirmeyi değiştirir. Resmî ücretlendirme, girdi ve çıktı videolarının sürelerini birlikte hesaba katar ve minimum token tabanı uygulayabilir. Milyon token başına $4.30 olan ücret, video yönlendirmeli bir görevin aynı koşullardaki yalnızca metin kullanan görevden daha ucuza mal olacağını garanti etmez. Yalnızca formüle güvenmek yerine gerçek kullanımı ve hesap faturasını kontrol edin.
- Bazı açıklamalar belirsizliğini koruyor. Flash ağ geçidi şeması
extra.priority,extra.safety_identifierveextra.toolsalanlarını sunuyor, ancak açıklamalarında hâlâ “yalnızca 2.0 serisi” yazıyor. Ark’ın görev oluşturma başvuru belgesinde ise 2.5 ailesi için depriorityvetoolslisteleniyor. Şemada yer almaları, bu özelliklerin AIHubMix üzerindeki etkisini tek başına doğrulamaz; üretimde kullanmadan önce ilgili özelliği doğrulayın.
Kullanım öncesi kontrol listesi
- Asenkron görevleri etkinleştirin ve hesap bakiyesini kontrol edin.
/ai/v1/videosile kısa Flash kimliğini kullanın ve güncel şemasını alın.- 480p veya 720p seçin ve 4–30 saniye aralığında açık bir süre belirtin.
- Referansları 10 görsel, 5 video ve 5 ses klibiyle sınırlayın.
- Kare referanslarını ayrı tutun ve bunlar için uyarlanabilir oranı kullanın.
- Gerçek kişilerin benzerliğine dayalı referansları, doğrulanmış ve etkin varlıklar üzerinden yönlendirin.
- Görev kimliğini kaydedin, görevin son durumunu kontrol edin ve sonucu hemen indirin.
- Üretim durumu belirsizse mevcut göreve yönelik sorguları veya indirmeleri yeniden deneyin.
Sık sorulan sorular
Flash için OpenAI uyumlu /v1/videos yolunu kullanabilir miyim?
Güncel Flash şemasında yalnızca /ai/v1/videos listeleniyor. Bu kılavuzdaki örnekler için yerel asenkron yolu kullanın.
Kare görseli isteğim aspect_ratio: "16:9" nedeniyle neden başarısız oluyor?
Flash şeması, boş olmayan frame_images sağlandığında aspect_ratio: "adaptive" kullanılmasını gerektirir. Son kare için ilk kare de gerekir ve kare referansları, boş olmayan input_references ile birlikte kullanılamaz.
doubao_real_person_required hatasını nasıl düzeltebilirim?
Kişisel doğrulama ve varlık kaydı iş akışını izleyin, varlık etkinleşene kadar bekleyin ve varlığa bir URI ile referans verin. Bu kod, Doubao’nun belirli bir gizlilik reddini belirtir; bu kontrolde yeniden oluşturulmamıştır.
Kısa bir referans videosu neden formülün öngördüğünden daha pahalı olabilir?
Satıcının faturalandırma kuralları, girdi video içerdiğinde asgari bir token eşiği uygulayabilir. Formül bir tahmindir; ücretlendirilen tutar için gerçek tüketimi ve hesabın faturalandırma kayıtlarını kontrol edin.
Başarısız üretimler veya moderasyon reddi ücretlendirilir mi?
BytePlus ve Volcengine’in resmi faturalandırma kuralları, başarılı üretimleri ücretlendirir ve başarısız üretimlerin ya da içerik moderasyonu reddinin faturalandırılmadığını belirtir. AIHubMix’in hata belgeleri, geçmiş ücretleri kontrol etmek için faturalandırma kayıtlarına bakılmasını önerir; burada başarılı veya başarısız bir üretim için faturalandırma ölçülmemiştir.
Flash sonucunu indirmek için ne kadar sürem var?
İşlem tamamlanır tamamlanmaz indirin. Mevcut Seedance 2.5 kılavuzu URL’lerin yaklaşık 30 dakika geçerli olduğu konusunda uyarıyor; ancak Flash için kesin saklama süresi doğrulanmadı ve süre sonu alanının null olması sonucun kalıcı olduğu anlamına gelmez.
AIHubMix üzerinden MOV çıktısı ve düzenleme/uzatma destekleniyor mu?
Güncel Flash şeması ilgili alanları extra altında sunuyor ve satıcı bu özellikleri belgeliyor. Oluşturma testi yetersiz kota yanıtıyla durduğu için bu özelliklerin AIHubMix üzerinden uçtan uca çalışması doğrulanmadı.
Okumaya devam edin: Seedance 2.5 Flash serisi
- Model seçmeden önce fiyat karşılaştırmasına ve çözünürlük seçeneklerinin ödünleşimlerine mi ihtiyacınız var? Seedance 2.5 Flash ve 2.5 ile 2.0 karşılaştırması: Yükseltmeye değer mi?
Kaynaklar
Belgeler ve şema 16 Kasım 2026'da kontrol edildi; doğrulama yanıtları 08:26 UTC'de kaydedildi. Fiyatlar, ölçülmüş ağ geçidi ücretleri değil, resmi BytePlus tahminleridir.
- Video Üretimi API’si (AIHubMix Belgeleri)
- Asenkron Görevler API’si (AIHubMix Belgeleri)
- Doubao Gerçek Kişi Varlıkları Kılavuzu (AIHubMix Belgeleri)
- ModelArk Fiyatlandırması (BytePlus)
- Seedance 2.5 Kılavuzu (Volcengine Ark)



