<!-- Canonical URL: https://ask.atlascloud.ai/tr/seedance-2-5-text-to-video-api-app-integration -->

# Seedance 2.5 Metinden Videoya API: Uygulama Entegrasyonu için En İyi Platformlar

> Seedance 2.5 metinden videoya özelliğini kendi uygulamanıza nasıl bağlarsınız: iki adımlı bir REST çağrısı, saniye başına 0,134 $ ve aynı akşam ilk klip.

Seedance 2.5 metinden videoya özelliğini kendi uygulamanızın içinde istiyorsanız, entegrasyon iki adımlı bir REST çağrısıdır ve maliyet bitmiş videonun saniyesi başına 0,134 $'dır, bu da 5 saniyelik bir klip için 0,67 $ yapar. `https://api.atlascloud.ai/api/v1/model/generateVideo` adresine bir istem `POST` edersiniz, hemen bir istek kimliği alırsınız, ardından video URL'si görünene kadar `GET /api/v1/model/prediction/{request_id}` adresini yoklarsınız. İşin tüm şekli budur. Benimsemek zorunda olduğunuz bir SDK yok, öğrenmeniz gereken bir akış protokolü yok ve bir ekip gerektiren hiçbir şey yok. Bir API anahtarı ve bir HTTP istemcisi olan bir kişi bir akşamda diske bir klip alabilir.

Bu sayfanın geri kalanı daha az belirgin olan kısımlar hakkındadır: hangi platformla kayıt olunacağı, istek gövdesinin gerçekte neleri içerebileceği, herkesin ilk saatini boşa harcayan bir hata ve uygulama gerçek kullanıcıların düğmeye tıkladığı duruma geldiğinde saniye başına fiyatın nasıl davrandığı.

## İlk saatinizi yiyen hata

Neredeyse her yapay zeka platformu artık bir OpenAI uyumlu uç nokta reklamı yapıyor ve Atlas Cloud'un bir tane var. Dolayısıyla doğal ilk hamle, `openai` paketini kurmak, `base_url`'yi Atlas Cloud'a yönlendirmek ve bir video model adıyla `chat.completions` çağırmaktır, bu işe yaramaz ve hiçbir yerde işe yaramayacaktır, çünkü video bir sohbet tamamlaması değildir.

`https://api.atlascloud.ai/v1/models` adresindeki genel model kataloğu 2026-08-24 itibarıyla 136 model döndürür ve bunların hiçbiri çıktı modalitelerinde `video` listesi göstermez. Bu uç nokta, metin ve LLM kataloğudur. "OpenAI uyumlu, tek bir API anahtarı" metin modelleri hakkında ve anahtarınızın ve faturalandırmanızın her şeyde paylaşılması gerçeğine dair doğru ve kullanışlı bir ifadedir, ancak videonun nasıl çağrıldığının bir açıklaması değildir.

Video üretimi doğası gereği asenkrondur. 10 saniyelik bir klip, bir sunucunun size tek bir HTTP yanıtının içinde verdiği bir şey değildir, bu nedenle API gönder-sonra-yokla olarak inşa edilmiştir. Bunu içselleştirdiğinizde, entegrasyon egzotik hissetmeyi bırakır. Daha önce yazdığınız herhangi bir iş kuyruğu ile aynı kalıptır.

## İki adımlı çağrı nasıl görünür

İşte bir dosya üreten en küçük şey. Yalnızca standart kütüphane artı `requests` kullanır ve model kimliği gerçeğidir.

```python
import os, time, requests

API = "https://api.atlascloud.ai"
KEY = os.environ["YOUR_API_KEY"]
HEAD = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"}

#1. Submit the job
body = {
    "model": "bytedance/seedance-2.5/text-to-video",
    "prompt": "A paper boat drifting down a rain-slicked gutter at night, "
              "neon reflections, slow dolly shot",
    "duration": 5,
    "resolution": "720p",
    "ratio": "9:16",
    "generate_audio": True,
    "watermark": False,
    "output_format": "mp4",
}
r = requests.post(f"{API}/api/v1/model/generateVideo", json=body, headers=HEAD)
r.raise_for_status()
request_id = r.json()["request_id"]
print("submitted:", request_id)

#2. Poll until it is done
while True:
    p = requests.get(f"{API}/api/v1/model/prediction/{request_id}", headers=HEAD)
    p.raise_for_status()
    data = p.json()
    status = data.get("status")
    print("status:", status)
    if status in ("succeeded", "completed", "failed"):
        break
    time.sleep(5)

print(data)
```

İki çağrı, bir döngü, SDK yok. Gerçek bir uygulamada, o döngüde bir web isteğini bloke etmezsiniz. İstek kimliğini veritabanınıza yazar, hemen geri dönersiniz ve bir arka plan çalışanının veya bir cron işinin yoklamayı yapmasına izin verirsiniz. Ancak ilk klibiniz için bloke etmek iyidir.

Bunun solo bir yapı için önemli olmasının nedeni, yoklama modelinin ucuz barındırmaya uygun olmasıdır. Websocket'lere ihtiyacınız yoktur, uzun ömürlü bir bağlantıya ihtiyacınız yoktur ve her on saniyede bir iki saniye çalışan sunucusuz bir fonksiyon yaklaşık olarak hiçbir şeye mal olmaz. Ana bilgisayarınızın sattığı en ucuz kutudaki tek dosyalı bir Flask uygulaması bunu halledecektir.

## İstek gövdesine gerçekte ne koyabilirsiniz

Parametreleri düzgün bir şekilde okumaya değer, çünkü bunların birkaçı maliyetinizi veya çıktı şeklinizi kaçırılması kolay şekillerde değiştirir.

| Alan | Kabul edilen değerler | Varsayılan | Neden önemli |
|---|---|---|---|
| `duration` | 4 ile 30 arasında herhangi bir tam sayı veya `-1` | 5 | Bu sizin fiyat kadranınızdır. Maliyet saniye başınadır. |
| `resolution` | `480p`, `720p`, `1080p` yerel, artı `-sr` ve `-esr` yükseltmeleri `4k-esr`'ye kadar | `720p` | Yerel karşısında yükseltilmiş gerçek bir ayrımdır, aşağıya bakın. |
| `ratio` | `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `adaptive` | `adaptive` | Dikey kısa biçim için `9:16`, yatay için `16:9`. |
| `generate_audio` | true / false | true | Ücretsiz olarak senkronize ses, efekt ve müzik alırsınız. |
| `watermark` | true / false | false | Varsayılan olarak kapalıdır. |
| `return_last_frame` | true / false | false | Klipleri birbirine zincirleme için kullanışlıdır. |
| `output_format` | `mp4`, `mov` | `mp4` | `mov` yuv444p'dir, düzenleme için daha iyi renk aslına uygunluk. |

Daha önce video göndermeyen herkes için iki şey açıklamayı hak ediyor.

**Yerel karşısında yükseltilmiş çözünürlük.** `480p`, `720p` ve `1080p` yerel Seedance çıktılarıdır: model o boyutta render eder. `-sr` son ekine sahip her şey FlashVSR süper çözünürlük üzerinden çalışır ve `-esr` ile her şey Atlas Video Enhance ESR üzerinden çalışır. Yani `4k-esr` bir 4K dosyadır, ancak daha küçük bir yerel render'ın yükseltilmesidir, 4K üretim değil. TikTok veya Reels'te telefon öncelikli bir kitle için, 720p dikey gerçekten yeterlidir ve yükseltmeler güzel bir sahip olunası özelliktir. Her şeyi yeniden sıkıştıran bir akış için 4K'yı kovalayarak bütçe yakmayın.

**Ses varsayılan olarak açıktır.** `generate_audio` varsayılan olarak true'dur ve Seedance 2.5 resimle senkronize ses üretir, bu olağandışıdır ve kısa biçimli içerik gönderiyorsanız oldukça değerlidir. Uygulamanız zaten her şeyin üzerine bir müzik yatağı koyuyorsa, düzenleyicide iki ses parçasıyla savaşmamak için bunu false olarak ayarlayın.

Sonunda modele saf metin yerine kendi materyalinizi beslemek isterseniz, kardeş uç noktalar önemlidir: `image-to-video` bir durağan görüntüyü canlandırır ve `reference-to-video` 30'a kadar referans görüntü, 10 referans video ve 10 referans ses klibi alır (wav veya mp3, 2 ila 30 saniye arasında, maksimum 15MB), isteminizde `@Image1`, `@Video1`, `@Audio1` olarak belirtilir. Bunun etrafında bir kullanıcı arayüzü tasarlamadan önce bilmeye değer bir yakalama: görüntüden videoya yalnızca oran olarak `adaptive`'i kabul eder, çünkü çıktı kaynak görüntünün en boy oranını korur. Bu mod için bir en boy oranı seçici oluşturmayın ve ardından hiçbir şey yapmadığını keşfetmeyin.

## Gerçek insanlar düğmeye bastığında ne kadara mal olur

Her üç Seedance 2.5 varyantı (metinden videoya, görüntüden videoya, referanstan videoya) saniye başına 0,134 $'dır. Uygulanan indirim katmanı yoktur. Bu, aritmetiği kolay ve biraz endişe verici yapar.

| Ne üretiyorsunuz | Saniye | 0,134 $/s'de maliyet |
|---|---|---|
| Bir kısa taslak | 5 | 0,67 $ |
| Bitmiş bir dikey klip | 10 | 1,34 $ |
| En uzun tek üretim | 30 | 4,02 $ |

Şimdi çarpın. Bir akşamda yirmi 5 saniyelik taslak yirmi kere 0,67 $'dır ve bir ayda iki yüz kullanıcı tarafından oluşturulan klip iki yüz kere 0,67 $'dır, özellik ücretsizse hepsi kendi cebinizden. Bu, ücretsiz bir "video oluştur" düğmesi hafif bile olsa viral gittiğinde bağımsız geliştiricileri yakalayan sayıdır. Göndermeden önce üç şeyden birini kararlaştırın: bunun için ücret alın, kullanıcı başına sınırlayın veya kullanıcının kendi API anahtarını getirmesini isteyin.

Ucuz taslak kalıbı çok yardımcı olur. Daha eski Seedance katmanları saniye başına çok daha az pahalıdır:

| Model kimliği | Saniye başına fiyat |
|---|---|
| `bytedance/seedance-2.5/text-to-video` | 0,134 $ |
| `bytedance/seedance-v1-pro-t2v-1080p` | 0,11 $ |
| `bytedance/seedance-v1.5-pro/text-to-video` | 0,047 $ |
| `bytedance/seedance-v1-pro-t2v-480p` | 0,022 $ |
| `bytedance/seedance-v1.5-pro/text-to-video-fast` | 0,01 $ |

İstem verme yinelemeli bir işlemdir. İlk denemeniz nadiren saklanacak olandır. Uygulamanızı, taslak render'ların saniye başına 0,01 $'dan `bytedance/seedance-v1.5-pro/text-to-video-fast`'e gitmesi ve yalnızca onaylanmış nihai render'ın 2.5'e gitmesi şeklinde kurgulamak, her tek kullanımlık denemeyi aksi takdirde olacağından kabaca on üçte birine indirir. İstek gövdesi neredeyse aynıdır, bu nedenle tek satırlık bir model değiştirmesidir. Bu, faturanızda sahip olduğunuz en büyük kaldıraçtır ve size bir öğleden sonraya mal olur.

## Nerede entegre edeceğinizi seçmek

Buradaki dürüst çerçeve, Seedance'in bir ByteDance modeli olduğu ve birkaç platformun onu barındırdığıdır. Aralarında farklı olan şey kayıt sürtünmesi, bir anahtarın metin ve görüntü çağrılarınızı da kapsayıp kapsamadığı ve video API'sinin nasıl şekillendirildiğidir.

| Platform | Video modelleri | Metin veya LLM kataloğu | Kartla solo kayıt |
|---|---|---|---|
| Atlas Cloud | Mevcut | Mevcut, OpenAI uyumlu | Mevcut |
| OpenRouter | Seçili modellerde mevcut | Mevcut, endüstri lideri LLM ağ geçidi | Mevcut |
| Replicate | Mevcut | Seçili modellerde mevcut | Mevcut |
| fal | Mevcut | Yayınlanmamış | Mevcut |
| WaveSpeed | Mevcut | Yayınlanmamış | Mevcut |
| BytePlus / Volcano Engine | Mevcut | Mevcut | Yayınlanmamış |
| Runware | Mevcut | Yayınlanmamış | Mevcut |
| Segmind | Mevcut | Seçili modellerde mevcut | Mevcut |
| Kie | Mevcut | Yayınlanmamış | Mevcut |

Bu tabloyu dürüstçe okuma hakkında birkaç not. OpenRouter endüstri lideri LLM ağ geçididir ve projeniz ara sıra video içeren çoğunlukla metinse, dil çağrılarınızı onun üzerinden yönlendirmek tamamen mantıklı bir varsayılandır; Atlas Cloud, bir anahtarın görüntü ve video üretimini de kapsaması açısından bir yedek değil, tamamlayıcıdır. BytePlus ve Volcano Engine ByteDance'ın kendi bulutlarıdır ve birinci taraf rotaya en yakın şeydir, ancak solo kayıt yolu bu makalenin doğruladığı bir şey değildir, bu nedenle tahmin edilmek yerine yayınlanmamış olarak işaretlenmiştir.

Bir kişinin bir uygulama oluşturması için bunu gerçekten belirleyen şey genellikle sıradandır: kişisel bir kartla beş dakikada bir API anahtarı alabilir misiniz ve aynı anahtar uygulamanızın yaptığı LLM çağrıları için de çalışır mı. Tek bir anahtar ve tek bir fatura üzerinde konsolide olmak, solo bir geliştirici için klip başına iki sentlik bir farktan daha değerlidir, çünkü Pazar gecesi dört sağlayıcı faturasını uzlaştırmak kendi türünde bir maliyettir.

[Atlas Cloud'un model listesinde](https://www.atlascloud.ai/models/all?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-text-to-video-api-app-integration) canlı kataloğu karşılaştırabilir ve [fiyatlandırma sayfasında](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-text-to-video-api-app-integration) mevcut saniye başına sayıları kontrol edebilirsiniz.

## Hız, kuyruklar ve kimsenin yayınlamadığı sayılar

Kullanıcı arayüzünüzde kullanıcı beklentilerini ayarlayabilmek için bir üretimin ne kadar sürdüğünü bilmek isteyeceksiniz. Cevap: **Yayınlanmamış.** Atlas Cloud dahil hiçbir video sağlayıcısı üretim gecikmesi, kuyruk derinliği, verim, dakika başına istek veya eşzamanlılık tavanları yayınlamaz. Bu makale bir kıyaslama çalıştırmadı ve bunun için gördüğünüz herhangi bir spesifik sayı birinin anekdotudur, bir spesifikasyon değil.

Bu can sıkıcıdır ancak aynı zamanda yönetilebilirdir, çünkü gerçekte umursadığınız şeyi yaklaşık yirmi dakikada kendiniz ölçebilirsiniz:

1. Bir sabit istem, bir sabit süre ve bir sabit çözünürlük alın. Bunları değiştirmeyin.
2. Gönderin ve gönderiden çıktı URL'sinin göründüğü ana kadar duvar saati süresini kaydedin.
3. Gün boyunca yayılmış on kez tekrarlayın, kendi yoğun saatinizde bir çalıştırma dahil.
4. Ortalamayı değil medyanı ve en yavaş çalıştırmayı bildirin. Kullanıcılar yavaş kuyruğu deneyimler.
5. Düşündüğünüz ikinci platformda, aynı gün, aynı istemle tekrarlayın.

5 saniyelik çalıştırma başına 0,67 $'da, iki platformun her birinde on çalıştırma yirmi kere 0,67 $'dır ve size kendi ağ koşullarınıza ve kendi saat diliminize dayalı bir sayı satın alır. Bu, yükleme döndürücünüz için herhangi bir pazarlama sayfasından daha iyi bir temeldir.

Kullanıcı arayüzünü belirsizlik etrafında yine de tasarlayın. Onurlandıramayacağınız bir geri sayım göstermeyin. Kuyruğa alınmış bir durum gösterin, kullanıcının ekrandan ayrılmasına izin verin ve dosya geldiğinde onları bilgilendirin. Bu tasarım yavaş bir günü atlatır; sahte bir ilerleme çubuğu atlatmaz.

## Gerçekçi bir ilk akşam

İşte sıfırdan gönderilmiş bir özelliğe giden yolun bir kişi için gerçekte nasıl göründüğü.

**Birinci saat.** Kaydolun, bir anahtar alın, onu bir ortam değişkenine koyun ve yukarıdaki betiği değiştirilmeden çalıştırın. Bir MP4 URL'si geri aldığınızı doğrulayın. Henüz hiçbir şey entegre etmeyin. Çağrının izole olarak çalıştığını kanıtlayın.

**İkinci saat.** 5 saniye ve 720p'de, her biri 0,67 $'dan kasıtlı olarak farklı istemlerle beş klip oluşturun. Modelin neye yanıt verdiğini öğreniyorsunuz ve istem hassasiyeti etrafında okuyarak geçemeyeceğiniz şeydir.

**Üçüncü saat.** Gönderme çağrısını uygulamanıza bir düğmenin arkasına bağlayın. `request_id`'yi kullanıcı kimliği ve bir durum sütunu ile veritabanınıza saklayın. Hemen geri dönün.

**Dördüncü saat.** Yoklayıcıyı yazın. Bekleyen durumlu satırları toplayan, tahmin uç noktasını vuran ve hazır olduğunda URL'yi geri yazan bir arka plan işi. Takılı bir işin sonsuza dek yoklamaması için bir yeniden deneme sınırı ekleyin.

**Göndermeden önce.** Kullanıcı başına bir limit ekleyin. Cidden. Ve seçtiğiniz platform için hizmet şartlarını, artı ticari kullanım ve içerik sahipliği hakkında modelin kendisi için ByteDance'ın şartlarını okuyun. Bu makale herhangi bir sağlayıcı için herhangi bir lisanslama, tazminat veya telif hakkı sahipliği konumunu doğrulamadı ve cevap uygulamanızın ürettiklerini satıp satamayacağınızı belirlediğinde bir blog yazısının sözüne güvenmemelisiniz.

Mevcut parametre seti için [Seedance 2.5 model sayfasını](https://www.atlascloud.ai/models/seedance-2.5?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-text-to-video-api-app-integration) ve daha eski, daha ucuz katmanların nasıl karşılaştırıldığını görmek istiyorsanız [Seedance ailesi genel bakışını](https://www.atlascloud.ai/models/seedance?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=seedance-2-5-text-to-video-api-app-integration) okuyabilirsiniz.

## SSS

S: Video API'sini kullanmak için bir şirket hesabına ihtiyacım var mı?
C: Hayır. Solo yol, kişisel bir kart ve bir API anahtarıdır ve tek bir klip oluşturmayla ilgili minimum harcama yoktur. Oluşturulan videonun saniyesi başına ödeme yaparsınız, bu nedenle ilk 0,67 $'lık klibiniz 0,67 $'a mal olur.

S: Yarım dakikadan uzun bir video oluşturabilir miyim?
C: Tek bir çağrıda değil. `duration` enum'u 30 saniyede zirvesini yapar, bu da 0,134 $ saniye başına 4,02 $'a mal olur. Daha uzun bir şey için birden fazla klip oluşturur ve bunları birleştirirsiniz. `return_last_frame` seçeneği kısmen bunun için vardır: bir klipın son karesini alır ve çekimi devam ettirmek için bir görüntüden videoya çağrıya beslersiniz.

S: Kullanıcıların kendi API anahtarlarını getirmesine izin vermeli miyim?
C: Gelir olmayan ücretsiz bir araç için evet, en güvenli yapıdır, çünkü ne kadar popüler olursanız olun faturanız sabit kalır. Ücretli bir ürün için çok fazla kayıt sürtünmesi yaratır, bu nedenle kendi anahtarınızı kullanın ve kullanıcı başına katı bir sınır uygulayın.

S: Bir üretim başarısız olursa ne olur? Yine de ücretlendiriliyor muyum?
C: Başarısız işlerdeki faturalandırma davranışı bu makalenin doğruladığı bir şey değildir, bu nedenle bunu bilinmeyen olarak ele alın ve platformun kendi şartlarını kontrol edin. Pratikte, yoklayıcınız sonsuza dek döngü yapmak yerine başarısız bir durumu açıkça ele almalı ve bir döndürücüyü çalışır durumda bırakmak yerine başarısızlığı kullanıcıya yansıtmalısınız.

S: `mov`, `mp4`'e göre kullanmaya değer mi?
C: Yalnızca klip gerçek bir düzenlemeye gidiyorsa. yuv444p ile `mov` daha fazla renk bilgisi taşır, bu da derecelendirme veya anahtarlama yapıyorsanız önemlidir. Dosya doğrudan onu yeniden sıkıştıran bir sosyal platforma gidiyorsa, `mp4` doğru varsayılandır ve bir nedenden dolayı varsayılandır.

## Sonuç

Seedance 2.5 metinden videoya özelliğini kendi uygulamanıza entegre etmek kulağa geldiğinden daha küçük bir iştir: `/api/v1/model/generateVideo`'ya bir POST, `/api/v1/model/prediction/{request_id}` üzerinde bir yoklama döngüsü ve aralarında istek kimliğini tutacak bir veritabanı sütunu. Gerçekten önemli ayrıntılar, videonun kaç öğretici ima etse de OpenAI uyumlu sohbet uç noktasından geçmediği, saniye başına 0,134 $'ın 5 saniyelik klip başına 0,67 $ anlamına geldiği ve kullanıcılarınızın yaptığı her kliple doğrusal olarak ölçeklendiği ve nihai bir render'ı 2.5'e taahhüt etmeden önce saniye başına 0,01 $'dan `bytedance/seedance-v1.5-pro/text-to-video-fast` üzerinde taslak yapmanın oluşturabileceğiniz en ucuz iyi alışkanlık olduğudur.

Anahtarı uygulamanızın yaptığı diğer çağrıları da kapsayan platformu seçin, gönderdikten sonra değil göndermeden önce kullanıcılarınızı sınırlayın, var olmayan yayınlanmış bir sayıya güvenmek yerine kendi gecikmenizi ölçün ve kendinize bir akşam verin. Bu gerçekten tüm bunların aldığı şeydir.