Seedance 2.5 API: Uç Noktalar, Kimlik Doğrulama ve Video Üretimi İçin Geliştirici Rehberi

Seedance 2.5 API: Uç Noktalar, Kimlik Doğrulama ve Video Üretimi İçin Geliştirici Rehberi

Seedance 2.5, uzun süren, çok modlu bir video modelidir; yani onu çalıştıran API tek bir istek-yanıt değil, eşzamansızdır. Bir üretim görevi gönderir, tamamlanmayı yoklar ve sonucu indirirsiniz. Bu deseni, uç noktayı, kimlik doğrulama başlığını ve süre, çözünürlük ile referanslara ilişkin yük alanlarını anladığınızda geri kalanı kolaydır.

Bu rehber, tüm Seedance 2.5 API sözleşmesini adım adım incelemektedir: uç nokta, kimlik doğrulama, istek gövdesi, eşzamansız yoklama ve çalışan curl ile Python örnekleri. Hedef, model için ByteDance'ın sözleşmesini birebir yansıtan PixMind api-platform rotasıdır. Ayrıca Seedance 2.0 ve Kling API desenleriyle yan yana bir karşılaştırma, uçtan uca bir üretim hattı örnek olay incelemesi, üçüncü taraf geliştirici kaynakları ve hız sınırları, eşzamanlılık, webhook'lar ve kredi kontrollerini kapsayan genişletilmiş bir SSS içerir. Tüm uç nokta ve kimlik doğrulama ayrıntıları 2026-07-31 itibarıyla canlı arka uçta doğrulanmıştır.

Seedance 2.5 modeline genel bakış

Öne Çıkanlar

• Uç nokta: Görev oluşturmak için POST /api-platform/v1/generations; sonucu yoklamak için GET /api-platform/v1/task/{task_id}.
• Kimlik doğrulama: Authorization: Bearer <API_KEY> (veya X-API-Key başlığı); PixMind panelinde video kapsamıyla bir anahtar oluşturun.
• Yük: { model, prompt, duration, resolution, aspect_ratio, reference_images, reference_videos, generate_audio }.
• Eşzamansızdır: oluşturma çağrısı bir taskId döndürür; status ready olana kadar yoklar, ardından videoUrl değerini okursunuz.
• Sağlayıcılar arası yapı: Seedance 2.5, Seedance 2.0 ve Kling'in hepsi aynı gönder-sonra-yokla desenini kullanır. Uç nokta yolunda, referans bütçesinde ve alan adlarında farklılaşırlar.
• Üretim deseni: oluşturmada bir Idempotency-Key ekleyin, sınırlandırılmış yeniden deneme ve geri çekilme ile yoklayın, göndermeden önce kredileri doğrulayın ve yineleme için daha ucuz bir rotaya geri dönün.
• API erişimi PixMind üzerinde Yakında kullanıma sunulacaktır; rota belgelenmiş ve hazır, arka uç bağlantısı sonlandırılmak üzeredir.

Ön Koşullar: API Anahtarı Alın

Seedance 2.5 çağrıları hesabınızla sınırlı bir API anahtarıyla doğrulanır. PixMind api-platform panelinde bir tane oluşturun ve güvenle saklayın; herhangi bir gizli anahtar gibi muamele görün. Kaynak denetimine işleyeceğinize, kodda anahtarı bir ortam değişkeninden yükleyin:

export PIXMIND_API_KEY="pk-xxxxxxxxxxxxxxxx"

API anahtarı oluştur

PixMind üzerinde anahtar izinleri iş yüküne göre (image / video) kapsamlanır. Seedance 2.5 çağırmadan önce anahtarınızda video izninin etkin olduğundan emin olun.

Geliştirici notu: Anahtarları ortam bazında (dev / staging / prod) döndürün ve her anahtarı ihtiyaç duyduğu en düşük iş yüküyle sınırlandırın. Yalnızca video kapsamına sahip bir staging anahtarı bir image hattına sızamaz; bu da anahtar ele geçirilirse etki alanını sınırlandırır. Anahtarları sabit bir dönemde yeniden düzenleyin ve son kullanım zaman damgasını günlüğe kaydedin, böylece uyuyan anahtarları bulmak ve iptal etmek kolaylaşır.

İzle: Seedance 2.5 İş Akışı Turu

Kod yazmadan önce 2.5 yükseltmesini anlamanın en hızlı yolu resmi demo görüntülerini ve topluluk analizlerini izlemektir. Bu iki inceleme, API'nin açığa çıkardığı 30 saniyelik doğal üretimi, 4K çıktıyı, bölge düzeyinde düzenlemeyi ve 50 referanslı iş akışını ele almaktadır:

noscript yedeği: YouTube'da Seedance 2.5 demosu; 30 saniyelik doğal klipleri, bölge düzeyinde düzenlemeyi ve 50 çok modlu referansı kapsar.

İş akışı yükseltmelerinin bir üretim hattı için ne anlama geldiğine dair daha derin bir editöryel tartışma için, resmi şerit yanında "Seedance 2.5 Changes Everything" analizini de izlemek worth waiting:

noscript yedeği: YouTube'da Seedance 2.5 Changes Everything.

Seedance 2.5 API Sözleşmesi

Uç nokta

Üretim görevi oluştur:

POST /api-platform/v1/generations

Tamamlanmayı yokla:

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

Oluşturma uç noktası birleşik üretim giriş noktasıdır: model alanını okur ve buna göre yönlendirir. model: "seedance-2.5" gönderin; rota video hattını işler.

Kimlik Doğrulama

API anahtarını bir Bearer belirteci olarak gönderin (OpenAI SDK uyumlu):

Authorization: Bearer $PIXMIND_API_KEY

Kimlik doğrulama ara katman yazılımı, bu formu tercih ediyorsanız X-API-Key başlığını da kabul eder. Her ikisi de desteklenir; birini seçin ve istemci kodunuz boyunca tutarlı şekilde kullanın, böylece günlükler ve yeniden denemeleri izlemek daha kolay olur.

İstek Gövdesi

Referanslar hakkında: Seedance 2.5 tek bir istekte en fazla 50 çok modlu girdi kabul eder; görseller, videolar, metin ve ses bir arada. Her referansa tek ve açık bir rol verin (kimlik, şekil, hareket, palet, ritim) ve aynı özelliği talep eden varlıkları çıkarın.

Seedance 2.5 API, Seedance 2.0 ve Kling ile Karşılaştırıldığında

Mevcut video üretim API'lerinin çoğu aynı eşzamansız yapıyı paylaşır: görev oluşturmak için bir POST, tamamlanana kadar yoklamak için bir GET. Farklılaştıkları yerler ise uç nokta yolu, kimlik doğrulama geleneği, referans bütçesi ve yükteki alan adlarıdır. Aşağıdaki tablo, bir entegrasyon planlarken geliştiricilerin en sık karşılaştırdığı üç API için bu farklılıları eşler.

Birinci elden gözlem: Paylaşılan eşzamansız yapı, istemci kodunun sağlayıcılar arasında yeniden kullanılabilir olabileceği anlamına gelir. Oluştur ve yokla döngüsünü tek bir generate_video(model, payload) işlevinde sarın ve model kimliğini değiştirin; ardından aynı test düzeneğinden Seedance 2.5, Seedance 2.0 Fast ve Kling'i A/B test edebilirsiniz. Bu, entegrasyon kodunu yeniden yazmadan her çekim için doğru rotayı seçmenin en ucuz yoludur.

Pratik çıkarım: Ekibiniz Seedance 2.0 için zaten bir yoklama istemcisi kurduysa, 2.5'a geçiş bir model dizesi değişikliği ve yeni referans ile süre alanlarından ibarettir. Entegrasyonu yeniden tasarlamanız gerekmez.

Seedance 2.5 vs Kling model karşılaştırması

Adım 1: Üretim Görevi Oluşturun

İşte minimal bir oluşturma isteği: metin komutuyla 5 saniyelik, 720p, 16:9 bir klip. Idempotency-Key başlığı isteğe bağlıdır ancak herhangi bir üretim gönderimi için önerilir:

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"
  }'

Başarılı bir yanıt bir görev kimliği döndürür. Videoyu burada almazsınız; yoklayacağınız bir tanıtıcı alırsınız:

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

code: 400 ile birlikte "模型不存在或未配置" hatası görürseniz, seedance-2.5 için arka uç rotası henüz o uç noktada etkinleştirilmemiştir. Bu, bağlantı sonlandırılırken PixMind üzerindeki Yakında durumudur.

Adım 2: Görev Hazır Olana Kadar Yoklayın

Video üretimi eşzamansızdır. 1. adımdaki taskId ile görev uç noktasını yoklayın:

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

status alanı önce pending, sonra processing, ardından ready değerlerine geçer. 3 ila 5 saniyede bir yoklayın. Görev hazır olduğunda yanıt son video URL'sini içerir:

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

Son hata durumları failed, error, canceled ve cancelled şeklindedir. Bunları işleyin ve description alanını günlüklerinize yansıtın.

Geliştirici notu: Tek bir görev için 3 ila 5 saniyelik yoklama aralıkları uygundur, ancak ölçeklendikçe hızla çoğalırlar. 20 görevlik bir kuyruk için, her açık görevi döngü başına bir kez yoklayan tek bir dağıtıcı döngü tercih edin; görevler ilerledikçe üstel geri çekilme uygulayın (5 sn, 5 sn, 10 sn, 15 sn, 30 sn'de tavan). Bu, istek hacmini nazik tutarken tüm toplu işlem için p99 gecikmesini de uzatmaz.

Adım 3: Sonucu İndirin ve Kullanın

status ready olduğunda videoUrl değerini indirin (ve bir poster karesi için isteğe bağlı olarak coverUrl). Dosya standart bir MP4'tür; uygulamanızın gerektirdiği şekilde transkode edin, barındırın veya gömün.

Bir web açılış sayfası için tipik olarak otomatik oynatma için fast-start ile 8 ila 10 saniyelik bir H.264 klip sıkıştırma, bir WebP poster çıkarma ve her ikisini de kendi CDN'nizde barındırma yaparsınız. (PixMind, Seedance 2.5 vaka medyasını cdn.pixmind.io üzerinde barındırır.) API tarafından barındırılan videoUrl değerini üretimde sıcak bağlamayın, çünkü API URL'sinin kalıcı olması garanti edilmez.

Tam Python Örneği

İşte bir görev oluşturan, hazır olana kadar yoklayan ve video URL'sini yazdıran eksiksiz, çalıştırılabilir bir Python kod parçası. Bir Idempotency-Key, sınırlandırılmış bir yeniden deneme döngüsü ve bir zaman aşımı tavanı ekler; bunlar, bir üretim istemcisinin ihtiyaç duyduğu ancak bir merhaba-dünya örneğinin genellikle atladığı üç şeydir:

import time
import uuid
import requests

API_BASE = "https://aihub-admin.aimix.pro"
API_KEY = "your-pixmind-api-key"  # kapsam: 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. Bir idempotency anahtarıyla oluştur, böylece yeniden deneme ikinci faturalandırılan görevi başlatmaz
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. Sınırlandırılmış yeniden denemeler ve nazik geri çekilme ile yokla
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)  # geri çekilme, 30 sn'de tavan
else:
    raise TimeoutError(f"Task {task_id} did not finish in {max_attempts * 5}s")

Uçtan Uca Örnek Olay İncelemesi: 30 Saniyelik Ürün Videosu Hattı

Çoğu API rehberinin atladığı bölüm budur: gerçek bir ekibin yukarıdaki sözleşmeyi nasıl tekrarlanabilir bir üretim hattına dönüştürdüğü. Senaryo şu: D2C bir markada dört kişilik bir yaratıcı ekip, sabit bir bütçe ve kesin bir teslim tarihiyle bir ürün lansmanı için 30 saniyelik bir hero video üretiyor. Aşağıdaki desen, süreye zamanında shipped olan şekildir.

Hatta genel bakış

Ekip işi dört aşamaya böler: yineleme (Seedance 2.0 Fast üzerinde ucuz A/B testleri), final üretim (1080p / 30 sn'de tek bir Seedance 2.5 çalışması), inceleme ve bölge düzenlemeleri (hedeflenmiş Seedance 2.5 bölge yeniden üretimi) ve teslimat (transkode, poster, CDN yükleme). Her aşama aynı istemci kodunu kullanır; yalnızca model kimliği ve yük değişir. Bu ayrım, hattı kampanyalar arasında tekrarlanabilir kılar.

Referans tahsisi

Herhangi bir API çağrısından önce ekip, her referansa tek ve açık bir rol atar; komut ve yükün senkronize kalması için bu, paylaşılan bir elektronik tabloda kaydedilir. 50 girdilik bütçeden beş referans, her birinin tek bir görevi:

Komut her birini açıkça eşler: "@Image 1'deki karakteri değiştirmeden tut; @Image 2'deki ürünle eşle; @Video 1'i yalnızca kamera hareketi için kullan; kesimleri @Audio 1'e hizala." Bu eşleme, yaratıcı yönlendirme ile API yükü arasındaki sözleşmedir. Bir referansa rol atanmadıysa, isteğe girmez.

Yineleme aşaması (maliyet kontrolü)

30 saniyelik bir 2.5 çalışmasına harcama yapmadan önce ekip, komutu ve referansları Seedance 2.0 Fast üzerinde 5 saniye ve 720p'de doğrular. Bu, model: "seedance-2.0-fast" ile aynı POST /api-platform/v1/generations çağrısıdır. Üç yineleme, tek bir 2.5 çalışmasinin küçük bir bölümüne mâl olur ve bütçe taahhüt edilmeden referans çakışmalarını ortaya çıkarır. Dağıtıcı, her yinelemenin taskId, durum ve geçen saniyesini günlüğe kaydeder, böylece yaratıcı yönetmen varyantları yan yana karşılaştırabilir.

Birinci elden gözlem: Bu aşamayı atlayıp doğrudan 30 saniyelik bir 2.5 üretimine geçen ekipler, genellikle Fast üzerinde yakalayabilecekleri komut çakışmalarını düzeltmek için üç veya dört tam fiyatlı çalışma harcar. Yineleme aşaması, hattın tek en yüksek ROI'li parçasıdır ve güvenle shipped olan ekipler, onu zorunlu olarak ele alanlardır.

Final üretim (Seedance 2.5, 30 sn / 1080p)

Fast yinelemesi komutun okunduğunu doğruladığında ekip gerçek üretimi gönderir: model: "seedance-2.5", duration: 30, resolution: "1080p", beş referansın tamamı eklenmiş ve tam rol eşlemeli komut. Oluşturma çağrısı bir Idempotency-Key içerir; böylece CI çalıştırıcısından gelen bir ağ yeniden denemesi ikinci bir faturalandırılan görevi başlatmaz. Yaratıcı yönetmen, dağıtıcının onu işlemesine izin verilmeden önce final taskId gönderim günlüğünü inceler; bu, pahalı komut yazım hatalarını önleyen bir dakikalık bir kontroldür.

Yoklama, hatalar ve idempotency

Tek bir dağıtıcı görevi 5 saniyede bir, 30 saniyeye geri çekilerek yoklar ve 100 girişimde (yaklaşık 8 dakika) tavan yapar. Son hata durumları (failed, error) yalnızca hata açıklaması geçici bir arka uç sorununa işaret ediyorsa yeni bir Idempotency-Key ile tek bir yeniden deneme tetikler. Referans veya komut hataları yaratıcı yönetmene yansıtılır ve yeniden gönderimden önce düzeltilir; kör şekilde yeniden denenenmez. Dağıtıcı, girişim başına yapılandırılmış bir günlük satırı yazar (görev kimliği, durum, ilerleme, geçen saniye), böylece maliyet ve gecikme lansmandan sonra denetlenebilir.

Bölge düzenlemeleri

İncelemede müşteri, final çekimin sağ rafındaki ürünü değiştirmeyi ister. Ekip, yalnızca o alanı hedefleyen ve klibin geri kalan hareketini ve kimliğini koruyan bölge düzeyinde bir düzenleme görevi gönderir. Bu, müşteri işleri için en değerli 2.5 özelliğidir: bir günlük gidiş-dönüş, 10 dakikalık bir yeniden üretim olur. Hatt, orijinal taskId ile düzenleme taskId değerini proje günlüğünde bağlı tutar, böylece gönderilen her karenin kökeni izlenebilir.

Teslimat

Hazır videoUrl indirilir, web otomatik oynatma için fast-start ile H.264'e transkode edilir, coverUrl değerinden çıkarılan bir WebP posterle eşleştirilir ve ekibin CDN'sine yüklenir. Final varlıklar açılış sayfasına yüklenir ve yayımlamadan önce kare kare incelenir (kimlik, eller, ürün geometrisi, logolar, ses senkronizasyonu).

Maliyet disiplini

Hatt, harcamayı üç noktada tavanlar. Birincisi, yineleme çalışmaları 2.5 yerine Fast üzerinde gerçekleşir. İkincisi, her 2.5 gönderiminden önce bir kredi ön kontrolü, cüzdan bakiyesi seçilen süre ve çözünürlük için eşiğin altındaysa iptal eder. Üçüncüsü, dağıtıcıdaki katı lansman başına görev bütçesi, sınıra ulaşılınca yeni görev gönderimini reddeder. Seedance 2.5 fiyatlandırması yayımlanmamıştır; bu nedenle ekip her saniye başına rakamı bir tahmin olarak ele alır ve her kampanyadan önce güncel krediler için canlı üreticiyi okur.

50 Çok Modlu Referansı Yönetme

Manşet özelliği, en fazla 50 çok modlu girdi, yükte herkese açık URL dizileri olarak görünür:

{
  "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
}

Tüm referans URL'leri herkese açık şekilde erişilebilir olmalıdır. Her birine tek bir rol atayın ve o rolü komutta açıklayın ("@Video 1'i yalnızca vücut hareketi için kullan"), böylece model hangi girdinin hangi özelliği kontrol ettiğini bilir.

Geliştirici notu: Göndermeden önce her referans URL'sinin beklenen içerik türüyle HTTP 200 döndürdüğünü önceden doğrulayın. CDN korumalı bir varlıkta tek bir 403, üretimde failed görevlerin en yaygın nedenidir ve tam bir üretim bütçesini israf eder. İstemcinizde iki satırlık bir HEAD isteği kontrolü, bu hata sınıfının tamamını önler. Ayrıca, bir varlığı kampanya ortasında değiştirdiğinizde modelin aldığını sessizce değiştirmemesi için kararlı, içerik adresli URL'ler kullanın (örneğin yolda bir karma veya sürüm ile).

Hata İşleme ve Idempotency

• 401 "API Key 无效", yanlış anahtar veya anahtarın video kapsamı yok. Anahtarı ve izinlerini kontrol edin.
• 400 "模型不存在或未配置", seedance-2.5 rotası henüz bu arka uçta etkin değil. PixMind üzerinde bu, Yakında durumudur.
• 4001 "余额不足", istek geçerli ancak cüzdanınızda kredi yok; görev oluşturulmaz.
• 429 hız sınırı, üstel olarak geri çekilin ve yeniden deneyin; oluşturma uç noktası anahtar başına eşzamanlılık ve istek hızı tavanlarını uygular. Buna düzenli olarak yakalanıyorsanız, destekle iletişime geçerek limitleri artırın veya gönderimleri kısa aralıklara yayın.
• 502 / 504 ağ geçidi, geçici; oluşturma çağrısını aynı Idempotency-Key ile yeniden deneyin, böylece arka uç yinelenenleri kaldırır ve ikinci bir faturalandırılan görev başlatmazsınız.
• Yoklama zaman aşımı, girişimleri tavanlayın (örneğin 100 × 5 sn, yaklaşık 8 dakika) ve zaman aşımını tek bir yeniden denemeli bir hata olarak ele alın.

Üretim için, her oluşturma çağrısında bir Idempotency-Key başlığı iletin; böylece istemci yeniden denemesi ikinci bir faturalandırılan görevi başlatmaz. Mantıksal görev başına (HTTP girişimi başına değil) bir UUID kullanın, bir kez üretin ve kendi tarafınızda saklayın; böylece aynı mantıksal üretim, yeniden denemeler, CI yeniden çalıştırmaları ve kuyruk tekrarları arasında yinelenenlerden kaldırılır. Desen şu: kullanıcı (veya iş çalıştırıcısı) görev oluşturmaya karar verdiğinde UUID'yi üretin, ilk HTTP çağrısından önce kalıcı hale getirin ve aynı mantıksal görevin her yeniden denemesi için onu yeniden kullanın.

Üçüncü Taraf Geliştirici Kaynakları

Yukarıdaki sözleşme PixMind üzerindeki uygulama yoludur. ByteDance'ın temelindeki model ve resmi API yüzeyi hakkında daha derin bağlam için, 2026-07-31 itibarıyla doğrulanan, geliştiricilerin en sık başvurduğu kaynaklar şunlardır:

• BytePlus Seedance 2.5 kaynak sayfası, ai.byteplus.com/lumina/en/resource/bytedance-seedance-2-5. ByteDance'ın 2.5 için kendi çerçevesi; reklam videosu üretimi ve ürün demoları çevresinde şekillenmiştir. Yetenek anlatısı ve ByteDance'ın kendisinin hedeflediği kullanım örnekleri için yararlıdır. Doğrulanmış listeleme, 2026-07-31.
• BytePlus ModelArk API belgeleri, Seedance'ı ByteDance'ın bulutu üzerinden çağırmak için resmi geliştirici yüzeyi. Bağlanan rotanın neyi açığa çıkardığını doğrulamanız gerektiğinde alan adlarını ve modları çapraz kontrol edin, ardından bu adları istemcinizde yansıtın.
• Volcengine 火山方舟 (Volcano Engine Ark) belgeleri, volcengine.com/docs/82379. Aynı model ailesinin iç (Çin) uç noktası. Eşzamansız gönder-ve-yokla deseni PixMind rotasıyla aynıdır; alan adları ve kimlik doğrulama akışı biraz farklıdır. Doğrulanmış listeleme, 2026-07-31; entegre etmeden önce canlı yolu doğrulayın.
• MakeFun AI demo yeniden oluşturma rehberi, makefun.ai/seedance-2-5-demo-videos/. BytePlus ModelArk'ın referans ağırlıklı demo iş akışlarını yeniden oluşturmayı adım adım anlatır. Kendi komutunuzu tasarlamadan önce resmi görünümü yeniden üretmek istediğinizde yararlıdır.
• Topluluk analizleri, Topview/Medium 2.5 incelemesi, Pixo'nun FORCE kapsamı ve ToSea eksiksiz rehberi, hepsi iş akışı yükseltmelerini editöryel bir açıdan ele alır. Bağlam için yararlıdır, uç nokta ayrıntıları için değil; her zaman teknik özellikleri canlı API'ye karşı doğrulayın.

Geliştirici notu: Üçüncü taraf rehberler hızla eskir. Herhangi birini bir başlangıç noktası olarak ele alın ve entegre ettiğiniz gün uç nokta yollarını, alan adlarını ve kredi maliyetlerini bağlanan rotaya karşı doğrulayın. Bu rehberin uç nokta ve kimlik doğrulama ayrıntıları 2026-07-31'de doğrulanmıştır, ancak model hala piyasaya sürülme aşamasındadır; bu nedenle üretim lansmanından önce yeniden kontrol edin.

Seedance 2.5 API SSS

Seedance 2.5 API uç noktası nedir?

POST /api-platform/v1/generations ile bir görev oluşturun, ardından status ready olana kadar GET /api-platform/v1/task/{task_id} ile yoklayın. Model alanı seedance-2.5'tir.

Seedance 2.5 API'sine nasıl kimlik doğrulaması yaparım?

API anahtarınızı Authorization: Bearer <key> olarak gönderin. X-API-Key başlığı da kabul edilir. PixMind panelinde video izniyle bir anahtar oluşturun ve kaynağa gömmek yerine bir ortam değişkeninden yükleyin.

Seedance 2.5 API PixMind üzerinde mevcut mu?

Rota belgelenmiş ve hazır; arka uç erişimi sonlandırılmak üzerededir ve model Yakında olarak işaretlenmiştir. /api-platform/models/seedance-2-5 sayfasında uç nokta ve parametre referansı bulunur; /ai-video/seedance-2-5 sayfası bu arada web üreticisini barındırır.

Tek bir Seedance 2.5 isteğinde kaç referans gönderebilirim?

Tek bir istekte en fazla 50 çok modlu girdi; görseller, videolar, metin ve ses bir arada. Bu, Seedance 2.0'daki 9'dan yukarıdır. Her referans herkese açık şekilde erişilebilir bir URL olmalıdır.

Seedance 2.5 API videoyu eşzamanlı olarak döndürür mü?

Hayır. Video üretimi eşzamansızdır. Oluşturma çağrısı bir taskId döndürür; status ready olana kadar görev uç noktasını yoklar, ardından videoUrl değerini okursunuz. Tipik bir 30 saniyelik üretim birkaç dakika sürer; bu nedenle istemcinizi engellemek için değil, yoklama için tasarlayın.

Hız sınırları ve eşzamanlılık tavanları nelerdir?

Oluşturma uç noktası, anahtar başına istek hızı ve eşzamanlılık limitlerini uygular. Bunları aşarsanız yanıt 429 döndürür ve üstel olarak geri çekilmelisiniz. Toplu iş yükleri için (birkaç eşzamanlı görevden fazlası), gönderimleri kısa aralıklara yayınlayın ve 429'a düzenli olarak yakalanırsanız limitleri artırmak için destekle iletişime geçin. Kesin sayısal limitler hesap bazında ayarlanır; bu nedenle büyük bir toplu iş tasarlamadan önce kendi anahtarınızda doğrulayın.

Seedance 2.5 API webhook'ları veya geri aramaları destekliyor mu?

Doğrulanmış PixMind rotası yalnızca yoklama tabanlıdır, itme geri aramaları değil. Mimariniz itme bildirimleri gerektiriyorsa, görev uç noktasını yoklayan ve status son bir duruma ulaştığında aşağı akış hizmetlerinize bir webhook yayan tek bir dağıtıcı çalıştırın. Bu, entegrasyonu basit tutar ve hattınızı ortamlar arasında değişebilecek bir geri arama URL'sine bağlamaktan kaçınır.

Aynı anda kaç görev çalıştırabilirim?

Eşzamanlılık, anahtarınızın anahtar başına tavanları ve kredi bakiyenizle sınırlanır. 30 saniyelik 1080p işlerde, düzinelerce yerine bir avuç görevi paralel çalıştırmayı bekleyin. Canlı tavanı hesabınızda doğrulanmış olarak ele alın: küçük bir kalibrasyon toplu işi gönderin, kaç görevin aynı anda pending durumundan processing durumuna geçtiğini ölçün ve kuyruğunuzu bu sayıya göre boyutlandırın.

API hangi video biçimini döndürür?

Hazır görev, standart bir MP4 dosyasına işaret eden bir videoUrl ve bir poster karesi için coverUrl döndürür. İndirin ve teslim hedefinizin ihtiyaç duyduğu biçime transkode edin (web için fast-start ile H.264, sosyal medya için dikey kodlamalar, düzenleme mastering için ProRes). API tarafından barındırılan videoUrl değerini üretimde sıcak bağlamayın çünkü kalıcı olması garanti edilmez; ready durumunda dosyayı kendi CDN'nize kopyalayın.

Göndermeden önce kredileri nasıl kontrol ederim?

Seçtiğiniz süre ve çözünürlükteki güncel kredi maliyeti için canlı üreticiyi okuyun, ardından cüzdan bakiyenizi kontrol edin. Bakiye çok düşükse API 4001 "余额不足" döndürür; bu noktada görev oluşturulmaz. Üretim hatları için, cüzdanın karşılayamayacağı işi kuyruğa almamanız amacıyla, bakiye görev başına eşiğin altındaysa erken iptal eden bir gönderim öncesi bakiye kontrolü ekleyin.

"模型不存在或未配置" hatasını nasıl düzeltirim?

Bu 400 yanıtı, seedance-2.5 rotasının çağırdığınız arka uç uç noktasında etkin olmadığı anlamına gelir. PixMind üzerinde bu, arka uç bağlantısı sonlandırılırken Yakında durumudur. Belgelenen /api-platform/v1/generations yolunu model: "seedance-2.5" (küçük harf, tam) ile çağırdığınızı doğrulayın. İkisi de doğruysa ve hata devam ediyorsa, rota henüz hesabınızda açık değildir; /api-platform/models/seedance-2-5 sayfasını kullanılabilirlik için izleyin.

Hangi çözünürlükleri ve süreleri talep edebiliriz?

Tek seferde 30 saniyeye kadar süreler; 480p, 720p, 1080p ve doğal 4K çözünürlükler. Bağlanan rota bir alt küme açığa çıkarabileceğinden, göndermeden önce tam seçenekleri canlı üreticide doğrulayın.

Seedance 2.5 API fiyatlandırması yayımlandı mı?

Henüz değil. Başka yerde gördüğünüz her saniye başına rakamı bir tahmin olarak ele alın. Göndermeden önce seçtiğiniz süre ve çözünürlükteki güncel krediler için canlı üreticiyi okuyun ve hattınızı, entegrasyonu yeniden yazmadan bir fiyat güncellemesini kaldırabilecek şekilde yapılandırın.

Seedance 2.5 API ile İnşa Etmeye Başlayın

Seedance 2.5 API, standart bir eşzamansız video üretim sözleşmesidir: tek bir oluşturma çağrısı, tek bir yoklama döngüsü, tek bir indirme. Video kapsamına sahip bir anahtara sahip olduğunuzda, yukarıdaki curl ve Python örnekleri ilk entegrasyonu shipped etmek için ihtiyacınız olan her şeydir. Karşılaştırma tablosu ve hatt örnek olay incelemesi, bu sözleşmenin tek bir klipten müşteri düzenlemelerini, bütçe baskısını ve teslim tarihlerini atlatan tekrarlanabilir bir üretim iş akışına nasıl ölçekleneceğini gösterir.

→ Seedance 2.5 API rota referansının tamamını okuyun veya API erişimi sonlandırılırken modeli web üreticisinde deneyin.

Tüm Seedance rotalarını karşılaştırın

Uç nokta ve kimlik doğrulama ayrıntıları 2026-07-31 itibarıyla PixMind api-platform arka ucuna karşı doğrulanmıştır. Üçüncü taraf kaynak bağlantıları 2026-07-31'de doğrulanmıştır. Kling API karşılaştırma alanları tahmin olarak işaretlenmiştir ve canlı Kling belgelerine karşı doğrulanmalıdır. Seedance 2.5 fiyatlandırması yayımlanmamıştır ve yalnızca tahmin olarak işaretlenmiştir.