Seedance 2.5 API: Nasıl Çağrılır, Parametreler, Sınırlar ve Kredi Maliyetleri

Kısa yanıt: Seedance 2.5'i tek bir anahtarla Yovid API'si üzerinden çağırabilirsiniz. "model": "seedance-2.5" ve bir prompt ile POST https://yovid.ai/v1/videos/generations gönderin, ardından durum completed olana kadar GET /v1/tasks/{task_id} uç noktasını sorgulayın ve output.video_url değerini okuyun. Klipler 4 ile 30 saniye arasındadır ve tek bir istek referans olarak 30 görsele, 10 videoya ve 10 ses dosyasına kadar içerebilir. Faturalandırma web sitesiyle aynı Yovid kredilerini kullanır ve krediler yalnızca görev başarılı olduğunda düşülür.

İçindekiler

1. Seedance 2.5 API erişimi nereden geliyor?
2. Dört adımda hızlı başlangıç
3. İstek parametreleri
4. API üretim modunu nasıl seçer?
5. Referans ve medya sınırları
6. Bir istek ne kadar tutar?
7. Hatalar, yeniden denemeler ve istek sınırları
8. Eksiksiz bir Python örneği
9. Sık sorulan sorular

Seedance 2.5 API erişimi nereden geliyor?

Seedance 2.5, ByteDance Seed'in modelidir. ByteDance'in geliştiricilere yönelik kendi yolu bulut platformlarından geçer: 31 Temmuz 2026 tarihli duyuru, API erişiminin BytePlus ModelArk üzerinden geleceğini söylüyordu; basın haberlerine göre Volcano Engine 7 Ağustos'ta Çin'de API erişimini açtı ve ByteDance'in Seedance 2.5 sayfası BytePlus playground'una bağlantı veriyor.

Yovid, ByteDance ile bağlantısı olmayan bağımsız bir platformdur ve Seedance 2.5'i kendi API'si üzerinden sunar:

• Tek anahtar, tek fatura. Aynı anahtar ve aynı krediler Seedance 2.5, 2.0, 2.0 Fast, 2.0 Mini, 1.5 Pro ve 1.0 Pro Fast için geçerlidir.
• Sabit genel kimlikler. Siz seedance-2.5 gönderirsiniz; Yovid sağlayıcı model adlarını içeride tutar, böylece bunlar kodunuzu bozmadan değişebilir.
• Web sitesiyle aynı hesap. API üzerinden ürettiğiniz klipler zaten sahip olduğunuz planı ve kredileri kullanır.

Tam başvuru kaynağı Yovid API belgelerinde (İngilizce) yer alır; bu rehber Seedance 2.5'e özgü konulara odaklanır.

Dört adımda hızlı başlangıç

1. Bir API anahtarı oluşturun

Ayarlar → API Anahtarları sayfasını açın, anahtara bir ad verin ve oluşturun. Gizli anahtarın tamamı yalnızca bir kez gösterilir; bu yüzden onu bir gizli bilgi yöneticisinde saklayın ve sunucunuzda YOVID_API_KEY olarak yükleyin. Asla tarayıcı veya mobil uygulama koduna koymayın.

2. Bir görev oluşturun

curl https://yovid.ai/v1/videos/generations \
  -H "Authorization: Bearer $YOVID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "prompt": "A lighthouse keeper climbs a spiral staircase with a lantern, reaches the lamp room as a storm rolls in, and lights the great lamp. Wind howling, boots on iron steps.",
    "duration": 10,
    "quality": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }'

{
  "task_id": "vid_01JZK7R7KCYQ3T9F33A7K0J6XB",
  "status": "pending",
  "created_at": "2026-10-22T08:30:00.000Z"
}

3. Görevi sorgulayın

curl https://yovid.ai/v1/tasks/vid_01JZK7R7KCYQ3T9F33A7K0J6XB \
  -H "Authorization: Bearer $YOVID_API_KEY"

Durum pending veya processing olduğu sürece her 5–10 saniyede bir sorgulayın ve aralığı giderek artırın. Durum completed olduğunda video URL'si output.video_url içindedir; failed olursa sorgulamayı bırakın ve error alanını okuyun.

4. Kredilerinizi kontrol edin

curl https://yovid.ai/v1/credits \
  -H "Authorization: Bearer $YOVID_API_KEY"

available, yeni bir görevin kullanabileceği miktardır; reserved ise hâlâ çalışan görevler için ayrılmış olandır.

İstek parametreleri

API, bir görev oluşturmadan önce her değeri modele ve planınıza göre kontrol eder; izin verilmeyen bir şey varsa sorunlu alanı param içinde belirterek 403 veya 422 döndürür. Bir kareden başlarsanız çıktı o görselin oranını izler.

API üretim modunu nasıl seçer?

Hiçbir zaman sağlayıcı modu göndermezsiniz. Yovid, eklediğiniz medyaya göre modu seçer:

Referans modunda dosyalara prompt'ta her dizideki sıralarına göre başvurun: @image1, @image2, @video1, @audio1. Referanslı bir istek şöyle görünür:

{
  "model": "seedance-2.5",
  "prompt": "@image1 is the main character. @image2 is the ceramic mug she holds; keep its shape and logo. @image3 is the kitchen. She walks into the kitchen, pours coffee into the mug and turns to the window. Use @audio1 as her voice: she says, \"Finally, Saturday.\"",
  "image_urls": [
    "https://example.com/character.jpg",
    "https://example.com/mug.jpg",
    "https://example.com/kitchen.jpg"
  ],
  "audio_urls": ["https://example.com/voice-sample.mp3"],
  "duration": 12,
  "quality": "720p"
}

Ses referansları bir API özelliğidir: web sitesindeki oluşturucu görsel ve video alır, API ise bir ses, bir parça veya bir ritim için 10'a kadar ses dosyası ekler.

Referans ve medya sınırları

API belgelerindeki modeller ve girdiler (İngilizce) sayfasından:

Tüm medyalar herkese açık HTTPS URL'leri olmalıdır. Yovid; localhost'u, özel ağ adreslerini, içine kimlik bilgisi gömülmüş URL'leri ve çözümlenemeyen ana bilgisayar adlarını reddeder. Base64 yerine URL kullanın; sağlayıcı her istek gövdesini 64 MB ile sınırlar.

Bir istek ne kadar tutar?

API, web sitesiyle aynı kredilerle ve aynı fiyatlarla ücretlendirir. Kredi paketlerinin temel fiyatlarıyla Seedance 2.5, saniye başına 480p'de yaklaşık 3, 720p'de yaklaşık 6,1 kredi tutar; yani 720p'de 10 saniyelik bir klip yaklaşık 61, 30 saniyelik bir klip yaklaşık 183 kredidir. Aboneler saniye başına daha az öder.

• Referans videolar, referans klibin süresi artı çıktı süresi üzerinden daha düşük bir fiyatla ücretlendirilir: 480p'de saniye başına yaklaşık 2,1, 720p'de 4,6 kredi.
• content_filter kapatmak maliyeti 1,1 ile çarpar.
• Önce rezervasyon, sonra düşüm. Krediler görev oluşturulduğunda ayrılır ve yalnızca görev tamamlanırsa düşülür; başarısız bir görev kredileri iade eder.
• Plana göre erişim. Seedance 2.5 ücretli bir plan veya tek seferlik bir kredi paketi gerektirir. Ücretsiz bir hesap 403 plan_upgrade_required yanıtı alır.

Tamamlanan görev, kullandığı miktarı credits_used içinde bildirir. Planlar ve paketler için fiyatlandırma sayfasına, en ucuz başlangıç yolu için Seedance 2.5 ücretsiz mi? yazısına bakın.

Hatalar, yeniden denemeler ve istek sınırları

Her anahtar dakikada en fazla 120 isteğe izin verir ve sorgulamalar da buna dahildir. Oluşturma uç noktası henüz idempotency anahtarlarını desteklemiyor; bu yüzden ilk isteğin başarılı olup olmadığını bilmiyorsanız bir POST isteğini otomatik olarak yinelemeyin: ikinci bir görev oluşturup kredileri iki kez ayırabilirsiniz. Aldığınız her task_id değerini kaydedin.

Eksiksiz bir Python örneği

import os
import time

import requests

API = "https://yovid.ai"
HEADERS = {"Authorization": f"Bearer {os.environ['YOVID_API_KEY']}"}

create = requests.post(
    f"{API}/v1/videos/generations",
    headers=HEADERS,
    json={
        "model": "seedance-2.5",
        "prompt": (
            "0-10s: a courier in a yellow rain jacket runs out of a subway exit into a night street. "
            "10-20s: she weaves between umbrellas as a taxi brakes. "
            "20-30s: she stops at a door and knocks twice. Rain and traffic, no music."
        ),
        "duration": 30,
        "quality": "720p",
        "aspect_ratio": "16:9",
    },
    timeout=30,
)
create.raise_for_status()
task_id = create.json()["task_id"]

delay = 5
while True:
    task = requests.get(f"{API}/v1/tasks/{task_id}", headers=HEADERS, timeout=30)
    task.raise_for_status()
    data = task.json()
    if data["status"] == "completed":
        print(data["output"]["video_url"], data["credits_used"])
        break
    if data["status"] == "failed":
        raise RuntimeError(data["error"])
    time.sleep(delay)
    delay = min(delay * 1.5, 30)

Prompt, 30 saniyelik bir klibi doldurmanın en güvenilir yolu olan zamanlı beat'leri kullanır. Seedance 2.5 prompt rehberi olduğu gibi gönderebileceğiniz 13 prompt içerir; Kling 3.0, Veo 3.1 ve Seedance 2.0 karşılaştırmaları ise hangi model kimliğini çağıracağınızı seçmenize yardımcı olur.

Sık sorulan sorular

Resmî bir Seedance 2.5 API'si var mı?

ByteDance, Seedance 2.5'i geliştiricilere bulut platformları Volcano Engine ve BytePlus üzerinden sunar. Yovid API'si bağımsız bir alternatiftir: Seedance 2.5 ve diğer Seedance modelleri için tek anahtar ve tek kredi bakiyesi.

Yovid'de Seedance 2.5'in model kimliği nedir?

seedance-2.5. Diğer genel kimlikler seedance-2.0, seedance-2.0-fast, seedance-2.0-mini, seedance-1.5-pro ve seedance-1.0-pro-fast şeklindedir.

Seedance 2.5 API ile üretilen bir video ne kadar uzun olabilir?

Görev başına 4 ile 30 saniye arasında; duration ile ayarlanır.

Seedance 2.5 API'si hangi çözünürlükleri destekliyor?

API belgeleri seedance-2.5 için 480p ve 720p listeler. Planınız da bir üst sınır belirler; kalite bu sınırın üzerindeyse API, görevi oluşturmadan önce 403 döndürür.

Referans olarak ses gönderebilir miyim?

Evet; audio_urls içinde en fazla 10 MP3 veya WAV dosyası gönderebilir, prompt'ta bunlara @audio1, @audio2 vb. şeklinde başvurabilirsiniz. Ses referansları yalnızca API üzerinden kullanılabilir.

Başarısız bir görev kredi harcar mı?

Hayır. Krediler görev oluşturulduğunda ayrılır ve yalnızca görev başarıyla tamamlandığında düşülür.

Kaç istek gönderebilirim?

Anahtar başına dakikada en fazla 120 istek (sorgulamalar dahil); ayrıca planınıza bağlı bir eş zamanlı görev sınırı vardır. 429 yanıtı, beklemeniz ve geri çekilmeyle yeniden denemeniz gerektiği anlamına gelir.

Geliştirmeye hazır mısınız? Ayarlar → API Anahtarları sayfasından bir anahtar oluşturun ve API hızlı başlangıç rehberini (İngilizce) izleyin.