<!-- Canonical URL: https://ask.atlascloud.ai/tr/seedance-2-5-api-quickstart-first-video-atlas-cloud -->

# Seedance 2.5 API Hızlı Başlangıç: Atlas Cloud ile İlk Videoyu Oluşturun

> Bugün Atlas Cloud'da tek bir API anahtarı ve iki REST çağrısı ile çalışan bir Seedance video entegrasyonu gönderin, ardından lansmanda tek bir model dizesini değiştirerek Seedance 2.5'e geçin.

[Seedance 2.5](https://www.atlascloud.ai/models/seedance-2.5?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) duyurusunu okudunuz, 30 saniyelik oluşturulmuş klipler etrafında bir ürün özelliği çizdiniz ve şimdi kod yazmak istiyorsunuz. Sonra, yeni duyurulmuş bir modelle her geliştiricinin karşılaştığı duvara tosluyorsunuz: özellik sayfası canlı, ancak uygulamanızdan gerçekten çağırabileceğiniz uç nokta tamamen farklı bir soru.

İşte durumun dürüst versiyonu ve buna saygı duyan bir hızlı başlangıç. Atlas Cloud, [Seedance](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) 2.5 ailesi sayfasını yayınladı ve halihazırda [Seedance 2.0](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) ve 1.5'e hizmet veren aynı birleşik uç noktalarda 0. Gün erişimi taahhüt ediyor. Bu yazı yazılırken bu liste "Çok Yakında" olarak işaretlenmiş ve Seedance 2.5 için herhangi bir Atlas Cloud fiyatı yayınlanmamıştır. Bunun pratik anlamı iyi haber: bugün canlı bir Seedance katmanına karşı oluşturduğunuz entegrasyon, 2.5 lansmanında çalıştıracağınız entegrasyonun aynısıdır. Tek değişen model dizesidir.

Bu nedenle bu hızlı başlangıç iki iş yapar. Bugün gerçek bir uç noktadan gerçek bir video alır ve kodunuzu ve istemlerinizi, yükseltmenin tek satırlık bir fark olacağı şekilde yapılandırır.

## Seedance 2.5'te gerçekte ne gönderiliyor?

ByteDance'in resmi Seedance 2.5 sayfasına göre bu, hassas referans kontrolü ve güçlü düzenleme ile 30 saniyelik hikaye anlatımı için oluşturulmuş yeni nesil bir ses-video ortak oluşturma modelidir. Tasarım yapmaya değer somut iddialar:

* Tek bir üretimde 30 saniyeye kadar, daha uzun ve daha eksiksiz hikaye anlatımı için iki kez uzatma seçeneği ile
* Daha gerçekçi görsellerle daha pürüzsüz ve daha tutarlı hareket
* Niyeti, çerçevelemeyi ve sinematik dili yakalayan, sadece hareket aktarımından daha hassas referans videosu anlayışı
* Daha geniş bir ses ve görsel düzenleme isteği yelpazesinde daha güvenilir düzenleme
* Karmaşık prodüksiyon iş akışlarını hedefleyen beyaz model kontrolü ve yeşil ekran düzenlemesi, artı profesyonel kamera hareketi ve performans bloklama

Listede olmayanlara dikkat edin: kıyaslama tablosu, çözünürlük merdiveni, referans varlık sayısı yok. Bu çizgilerde gördüğünüz her şey birinin pazarlama cilasıdır, birinci taraf teknik özellik sayfası değil. Yukarıdaki iddialara göre inşa edin.

## Adım 1: konsoldan bir anahtar alın

console.atlascloud.ai adresinde oturum açın ve bir API anahtarı oluşturun. Depozito, minimum taahhüt veya bekleme listesi yoktur, bu nedenle anahtar kullandıkça öde üzerinde hemen kullanılabilir. Tek bir anahtar, metin, görüntü ve video arasında 300'den fazla modelin tam kataloğunu tek bir fatura hesabında kapsar; bu, bu hızlı başlangıç için önemli olan kısımdır: şimdi bastığınız anahtar, Seedance 2.5'i arayacak olan anahtarla aynıdır.

Bunu bir ortam değişkeni olarak saklayın, asla kaynak kodda değil. `ATLASCLOUD_API_KEY` iyi bir isimdir.

## Adım 2: bir video işi gönderin

Atlas Cloud'da video oluşturma, bir sohbet tamamlama değil, iki aşamalı asenkron bir REST çağrısıdır. Bir iş POST edersiniz ve bir tahmin kimliği alırsınız, ardından işleme bitene kadar bu kimliği yoklarsınız. Herhangi bir HTTP istemcisi işe yarar, bu nedenle kurulacak bir satıcı SDK'sı veya öğrenilecek yeni bir kimlik doğrulama şeması yoktur: yeni bastığınız anahtardaki bir taşıyıcı belirtecidir.

```python
import os, time, requests

KEY  = os.environ["ATLASCLOUD_API_KEY"]
BASE = "https://api.atlascloud.ai/api/v1/model"
HEAD = {"Authorization": "Bearer " + KEY, "Content-Type": "application/json"}

job = requests.post(f"{BASE}/generateVideo", headers=HEAD, json={
    "model": "bytedance/seedance-2.0/text-to-video",
    "prompt": "Handheld, subject-following medium shot of a courier weaving through a night market, "
              "neon reflections on wet asphalt, slight lag on turns.",
    "duration": 5,
    "resolution": "720p",
    "ratio": "adaptive",
    "bitrate_mode": "standard",
    "generate_audio": True,
    "watermark": False,
}).json()

prediction_id = job["data"]["id"]
```

Yanıt `{"code": 200, "data": {"id": "...", "status": "processing"}}` olarak gelir. `model`'in düz bir dize alanı olduğuna dikkat edin. Bu ayrıntı, bu makalenin tüm yükseltme hikayesidir ve 6. Adım buna geri dönecektir.

## Adım 3: işleme tamamlanana kadar yoklayın

5 saniyelik bir klip anlık bir yanıt değildir, bu nedenle işlemeyi engelleyici bir çağrı yerine bir yaşam döngüsüne sahip bir iş olarak ele alın. `status` terminal değerine ulaşana kadar tahmin uç noktasını yoklayın.

```python
while True:
    r = requests.get(f"{BASE}/prediction/{prediction_id}", headers=HEAD).json()
    status = r["data"]["status"]
    if status in ("completed", "succeeded", "failed"):
        break
    time.sleep(3)

print(status, r["data"])   # başarı durumunda yük çıktı URL(ler)ini taşır
```

Şimdi değil, daha sonra inşa etmeye değer iki şey. Sıkışmış bir işin bir istek işleyiciyi asılı bırakamaması için yoklama döngüsüne bir tavan koyun ve bir çöken işçinin işleme için iki kez ödeme yapmak yerine devam edebilmesi için yoklamaya başlamadan önce tahmin kimliğini kalıcı hale getirin. Her iki alışkanlık da 2.5'e değişmeden aktarılır.

Özelliğiniz saf metin yerine bir referans görüntü veya bir konu referansı ile çalışıyorsa, aynı akış farklı bir model varyantı ile geçerlidir: `bytedance/seedance-2.0/image-to-video` veya `bytedance/seedance-2.0/reference-to-video`. Konu referans varlıkları `uploadMedia` aracılığıyla bir kez yüklenir ve ardından görüntü alanlarında `asset://<id>` olarak iletilir, böylece yinelenen bir karakter veya ürünün her çağrıda yeniden yüklenmesi gerekmez.

## Adım 4: canlı bir Seedance katmanı seçin ve bir saniyenin ne kadara mal olduğunu bilin

Atlas Cloud, video için çıktı süresinin saniyesi başına fatura keser. Bu, herhangi bir kod yazmadan önce kafanızda yapabileceğiniz bir aritmetiktir. Bugün üç Seedance katmanı canlıdır:

| Model | Model ID | Atlas Cloud fiyatı | Önemli |
|---|---|---|---|
| Seedance 2.0 | `bytedance/seedance-2.0/text-to-video` | $0.112/s | Amiral gemisi canlı katman, anında anahtar, bekleme listesi yok |
| [Seedance 2.0 Fast](https://www.atlascloud.ai/models/bytedance/seedance-2.0-fast/text-to-video?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-2.0-fast/text-to-video` | $0.09/s | Aynı ailenin daha hızlı varyantı |
| [Seedance 2.0 Mini](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-2.0-mini/text-to-video` | $0.056/s | En ucuz canlı Seedance 2.0 katmanı, ayrıca görüntüden videoya ve referanstan videoya |
| [Seedance 1.5 Pro](https://www.atlascloud.ai/models/seedance2?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) | `bytedance/seedance-v1.5-pro/text-to-video` | $0.047/s veya Fast varyantında $0.018/s | Yerel senkronize ses, çok dilli dudak senkronizasyonu, 4 ila 12 saniyelik klipler |

Yönlendirme için, aynı anahtardaki diğer video modelleri benzer bir aralıkta çalışır: Grok Imagine Video v1.5 $0.080/s, [Wan 2.7](https://www.atlascloud.ai/models/alibaba/wan-2.7?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) $0.100/s, [Kling](https://www.atlascloud.ai/models/kling-v3?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-api-quickstart-first-video-atlas-cloud) V3.0 Turbo standart $0.112 ve indirimli $0.095, MiniMax H3 $0.14/s.

Hangisi üzerine inşa edileceği, 2.5 özelliğinizin sonunda ne yapacağına bağlıdır. Ses çıktının merkezindeyse, Seedance 1.5 Pro, halihazırda yerel senkronize sese ve çok dilli dudak senkronizasyonuna sahip olan katmandır, bu nedenle boru hattınız ilk günden itibaren bir ses parçasını işlemeyi öğrenir. İstem yapısı üzerinde yineleme yapıyorsanız ve deney başına en düşük maliyeti istiyorsanız, Seedance 2.0 Mini $0.056/s ile bariz kum havuzudur. Üretim düzeyinde bir güncel nesil işlemeye en yakın şeyi istiyorsanız, Seedance 2.0 $0.112/s ile basit seçimdir; kalitenin son artışından çok verim önemliyse Fast varyantı $0.09/s.

## Adım 5: Harcamadan önce Playground'da canlı fiyatı kontrol edin

İlk ücretli çağrınızdan önce modeli Atlas Cloud Playground'da açın. Her model, canlı model başına fiyatını Çalıştır düğmesinin yanında gösterir. Bu, kulağa geldiğinden daha önemlidir: promosyon indirimleri gelir ve gider ve Çalıştır düğmesinin yanındaki sayı, gerçekte fatura edilecek olan sayıdır. Playground'da bir oluşturma çalıştırın, çıktının özelliğinizin ihtiyaç duyduğu şey olduğunu onaylayın, ardından ayarları koda aktarın.

Çıktı başına saniye modeli ayrıca bütçe konuşmanızı da önemsiz hale getirir. Seedance 2.0 Mini'de 10 saniyelik bir klip 10 × $0.056'dır. Hesap makinesi, token tahmini veya sonradan mutabakat adımı yoktur.

Bu, birinci taraf ByteDance kanallarının Seedance'ı nasıl faturalandırdığıyla karşılaştırmaya değer. Çin'de Volcano Engine Ark ve uluslararası olarak BytePlus ModelArk'ta faturalandırma token tabanlıdır: tahmini token tüketimi (giriş video süresi + çıkış video süresi) × çıkış genişliği × çıkış yüksekliği × çıkış kare hızı / 1024, bir token birim fiyatı ile çarpılır, API yanıtındaki `usage.completion_tokens` alanından yetkili gerçek kullanım ile. Seedance 2.0 serisi ve Seedance 2.5 için, giriş video içerdiğinde, minimum token tüketim tabanı uygulanır ve taban, çözünürlüğe, en boy oranına ve çıkış süresine bağlıdır. ByteDance tam olarak bu nedenle bir fiyatlandırma hesaplayıcısı artı bir minimum token tablosu yayınlar.

Her iki model de meşrudur. Ancak 30 saniyelik bir işleme bütçesi yapıyorsanız, çıktı süresi başına saniye zihinsel aritmetiktir ve katlı tokenler bir elektronik tablo gerektirir.

## Adım 6: çekim açıklamasını zaten 2.5'miş gibi yazın

Bu, hızlı başlangıcın mükemmel bir şekilde aktarılan kısmıdır, çünkü istem işçiliği sürümlendirilmez. 2.5 yetenek iddialarından ikisi, bugün nasıl yazdığınızı değiştirmelidir.

**Hassas referans kontrolü.** ByteDance'in iddiası, 2.5'in bir referans videoyu niyeti, çerçevelemesi ve sinematik dili için okuduğu ve hareket aktarımının ötesine geçtiğidir. İstem çıkarımı, referans varlığınızın bir hareket şablonu olmaktan çıkıp bir yönetmenlik brifingi haline gelmesidir. Bu nedenle, yalnızca konuyu tanımlayan istemler yazmayı bırakın ve taşınmasını istediğiniz dilbilgisini adlandırmaya başlayın: lens hissi, çerçeveleme, kesimin hızı, kameranın konuyu yönlendirip yönlendirmediği veya takip edip etmediği. "kişi yürüyor, sinematik" yerine "handheld, subject-following medium shot, slight lag on turns" yazın.

**Tek bir üretimde otuz saniye.** 5 saniyelik bir klip tek bir çekimdir. Otuz saniye, yapısı olan bir sahnedir ve 2.5 bunun üzerine iki kez uzatmayı destekler. Bu nedenle, tek bir statik açıklama yerine bir vuruş yapısına sahip çekim açıklamaları yazın: bir kuruluş vuruşu, bir değişiklik (bir dönüş, bir giriş, bir açıklama) ve bir çözüm. Kamera hareketini ve performans bloklamasını açıkça adlandırın, çünkü bunlar tam olarak 2.5'in hedeflediği kontrollerdir. Konunun nerede durduğu, nereye hareket ettiği, onlar hareket ederken kameranın ne yaptığı.

Her iki alışkanlık da şimdi canlı katmanlarda karşılığını verir. Her ikisi de 2.5'in ödüllendirdiği tam alışkanlıklardır.

## Adım 7: değişimi planlayın

Kodunuzu, model tanımlayıcısının bir yapılandırma olacak şekilde yapılandırın, bir değişmez değil. Ortamdan veya yapılandırmadan okunan bir sabit:

```python
SEEDANCE_MODEL = os.environ.get("SEEDANCE_MODEL", "bytedance/seedance-2.0/text-to-video")
```

Ardından, 2. Adım'ın dizeyi sabit kodladığı yere `SEEDANCE_MODEL`'i iletin. `model`, `generateVideo` gövdesinde tek bir JSON dize alanı olduğundan, 2.5 lansmanındaki yükseltme gerçekten tek bir ortam değişkenidir. Küçük bir değişiklik için bir metafor değil, kelimenin tam anlamıyla tek bir değer.

Bugün asla bir Seedance 2.5 tanımlayıcısını sabit kodlamayın, çünkü henüz hiçbir Atlas Cloud Seedance 2.5 model kimliği mevcut değil. Canlı kimlikleri, bu makale de dahil olmak üzere bir makaleden kopyalamak yerine atlascloud.ai/models adresindeki katalogdan alın, çünkü zamanla yeni varyantlar eklenir. 2.5, 0. Gün taahhüdü altında kullanıma sunulduğunda, sizin tarafınızdaki iş, bu tek değişken, artı Çalıştır düğmesinin yanındaki fiyata yeni bir bakış ve herhangi bir yeni istek parametresinin yeniden okunmasıdır, çünkü 30 saniyelik bir modelin uzatma desteği ile muhtemelen 2.0 gövdesinde olmayan alanları kabul edecektir.

Bu arada, Atlas Cloud lansmanından önce Seedance 2.5'e ihtiyacınız varsa, dürüst cevap birinci taraf ByteDance kanallarıdır: Çin'de Volcano Engine Ark ve uluslararası olarak BytePlus ModelArk. Toplayıcılar arasında, birçoğu aynı ön lansman veya 0. Gün taahhüt durumundadır.

## SSS

S: Şu anda Atlas Cloud'da Seedance 2.5'i çağırabilir miyim?
C: Hayır. Atlas Cloud'daki Seedance 2.5 ailesi sayfası, halihazırda Seedance 2.0 ve 1.5'e hizmet veren aynı birleşik uç noktalarda 0. Gün erişim taahhüdü ile "Çok Yakında" olarak işaretlenmiştir. Bunun için henüz bir model kimliği ve fiyat yayınlanmamıştır.

S: Seedance'ın Atlas Cloud'daki maliyeti nedir?
C: Seedance 2.0 $0.112/s, Seedance 2.0 Fast $0.09/s, Seedance 2.0 Mini $0.056/s ve Seedance 1.5 Pro $0.047/s veya Fast varyantında $0.018/s'dir. Faturalandırma, çıktı süresinin saniyesi başına yapılır ve canlı fiyat Playground'daki Çalıştır düğmesinin yanında gösterilir.

S: Atlas Cloud'da video için özel bir SDK'ya ihtiyacım var mı?
C: Hayır. Video, düz bir REST akışıdır: bir iş göndermek için `POST /api/v1/model/generateVideo`, ardından yoklamak için `GET /api/v1/model/prediction/{id}`, her ikisi de Atlas Cloud anahtarınızda bir taşıyıcı belirteci ile kimlik doğrulaması yapar. Herhangi bir HTTP istemcisi çalışır. Metin kataloğunun kullandığı OpenAI uyumlu sohbet uç noktasından video geçmediğini unutmayın, bu nedenle `chat.completions`'ın bir klip oluşturmasını beklemeyin. Model başına istek parametreleri atlascloud.ai/docs adresinde belgelenmiştir.

S: Başlamak için bir depozito veya minimum taahhüt var mı?
C: Hayır. Atlas Cloud, depozito, minimum taahhüt veya bekleme listesi olmayan kullandıkça öde sistemidir ve console.atlascloud.ai'den alınan anahtar hemen kullanılabilir.

S: 2.5'i hedefliyorsam hangi canlı katmanda prototip yapmalıyım?
C: Ucuz istem yinelemesi için Seedance 2.0 Mini $0.056/s, boru hattınızın yerel bir senkronize ses parçasını işlemesi gerekiyorsa Seedance 1.5 Pro ve en yakın güncel nesil üretim işlemesi için Seedance 2.0 $0.112/s.

## Alt satır

Atlas Cloud, Seedance 2.0, Seedance 2.0 Fast, Seedance 2.0 Mini ve Seedance 1.5 Pro'yu bugün, çıktı süresi başına saniye faturalandırması, SOC II sertifikası, HIPAA uyumluluğu ve bekleme ve aktarım sırasında şifreleme ile tek bir API anahtarında çalıştırır ve Seedance 2.5'i kullanıma sunulduğunda aynı birleşik uç noktalarda sunmak için 0. Gün taahhüdü yayınlamıştır.

İlgili uygulama kılavuzu için bkz. [şu anda mevcut olan en son görüntü, video ve LLM API'leri](https://ask.atlascloud.ai/latest-image-video-llm-apis-available-now) ve [AI çıkarım kapasitesi, gecikme ve maliyeti tahmin etme](https://ask.atlascloud.ai/estimate-ai-inference-capacity-latency-cost).