Amiral gemisi çıktı kalitesi
Seedream 5 Pro, fotorealistik sahneler, editoryal ürün çekimleri ve doğru görsel içi metni 1K veya 2K'da render eder — GPT Image ve NanoBanana ile aynı seviyede.
Seedream 5 Pro API rehberi
Seedream 5 Pro, ByteDance'in amiral gemisi görsel modeli — güçlü çok dilli metin renderı, çok referanslı düzenleme ve temiz fotorealistik çıktı. Seedance API'de basit REST uç noktaları, asenkron görev sorgulama ve görsel başına kredi fiyatıyla kararlı bir takma ad olarak çağırırsın.
1K veya 2K çıktı
1:1'den 16:9, 9:16, 2:3, 3:2'ye
Prompt veya 10'a kadar referans görsel
HTTPS üzerinden JSON
Başlangıç isteği
curl -X POST 'https://seedanceapi.org/v1/images/generations' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "seedream-5-pro",
"prompt": "Studio product shot of a matte black water bottle on wet stone, soft top light",
"aspect_ratio": "4:3",
"resolution": "2k",
"image_urls": []
}'POST /v1/images/generations bir task_id döndürür. status SUCCESS olana kadar GET /v1/images/generations/:task_id sorgula ve images[].url'yi oku.
Ekipler, sağlayıcı SDK'sı ve sürpriz şema değişiklikleri olmadan amiral gemisi görsel kalitesini öngörülebilir bir REST yüzeyinin arkasında istediğinde Seedream 5 Pro API'yi seçer.
Seedream 5 Pro, fotorealistik sahneler, editoryal ürün çekimleri ve doğru görsel içi metni 1K veya 2K'da render eder — GPT Image ve NanoBanana ile aynı seviyede.
model "seedream-5-pro" çağırırsın. Sağlayıcı yönlendirmesi, kapasite ve yedekler bizde kalır — entegrasyonun upstream değişikliklerinden etkilenmez.
1K görsel başına 9 kredi, 2K başına 18, ikinci referans görselden itibaren her biri +0.8. estimated_credits her oluşturma yanıtında döner.
Herkese açık yüzey, modelin gerçekten yaptığını sunar: metin-görsel üretimi ve ona kadar referans görselle düzenleme.
En-boy oranı ve çözünürlükle 3000 karaktere kadar prompt gönder — kompozisyon, ışık ve görsel içi tipografiyi model halleder.
image_urls içine 1–10 genel HTTPS görsel URL'si vererek mevcut görselleri düzenle, birleştir veya yeniden stilize et — ürün değişimi, arka plan, stil transferi.
resolution'ı "2k" yaparak baskı kalitesinde renderlar ve son varlıklar al. 1K önizlemeler ve iterasyonlar için yeterli.
Modelin en güçlü yanlarından biri — poster ve tabelalarda İngilizce, Çince, Japonca ve daha fazlasıyla okunabilir metin.
Oluşturma anında task_id döndürür. Durumu kendi ritminde sorgula, UI'ı yanıtlı tut — uzun HTTP bağlantılarına gerek yok.
Upstream yönlendirmesi ne olursa olsun yanıt formatı sabit kalır — consumed_credits, status ve görsel URL'leri normalize edilir.
API anahtarından hazır görsel URL'sine üç adım.
Giriş yap, API Keys sayfasını aç ve sunucu tarafı kullanım için bir anahtar kopyala. Backend'de tut — asla tarayıcı koduna koyma.
model "seedream-5-pro", prompt'un, aspect_ratio, resolution ve isteğe bağlı image_urls ile POST /v1/images/generations çağır. task_id ve estimated_credits alırsın.
GET /v1/images/generations/:task_id çağır. status SUCCESS olduğunda images[0].url'yi oku ve sonucu göster veya arşivle.
İki uç nokta tüm yaşam döngüsünü kapsar — oluştur ve sorgula.
Seedream 5 Pro görevi oluşturur. Boş image_urls = metin-görsel; 1–10 URL = referans düzenleme. task_id ve estimated_credits ile 202 döner.
IN_PROGRESS, images[].url içeren SUCCESS veya hata nesneli FAILED döndürür. Tamamlandığında consumed_credits'i de bildirir.
400 geçersiz parametreler, 401 geçersiz anahtar, 402 yetersiz kredi, 404 görev bulunamadı, 429 hız limiti, 503 upstream kullanılamaz. Tam tablo dokümanda.
| Parametre | Değer |
|---|---|
| model | "seedream-5-pro" olmalı — bu rotadaki tek genel model. |
| prompt | Metin prompt'u veya düzenleme talimatı, 1–3000 karakter. |
| aspect_ratio | 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2'den biri. Varsayılan 1:1. |
| resolution | "1k" (varsayılan, 9 kredi) veya "2k" (18 kredi). |
| image_urls | 0–10 genel HTTPS URL. Boş dizi = saf metin-görsel. |
Bilinmeyen parametreler 400 UNKNOWN_PARAMETER ile reddedilir — sözleşme açık kalır. Tam şema /docs/images içinde.
Seedance API kredileriyle görsel başına sabit fiyat. Oluşturma yanıtı estimated_credits içerir; tamamlanan durum consumed_credits bildirir.
| Mod | Krediler | Notlar |
|---|---|---|
| Metin-görsel · 1K | 9 kredi / görsel | Varsayılan çözünürlük — iterasyonlar ve önizlemeler için. |
| Metin-görsel · 2K | 18 kredi / görsel | Son varlıklar için baskı kalitesi çıktı. |
| Referans düzenleme | Ek görsel başına +0.8 kredi | İlk referans temel fiyata dahil; 2–10. görseller her biri +0.8. |
Seedance API'de Seedream 5 Pro API'yi değerlendiren geliştiriciler için yanıtlar.
Seedance API, Seedream 5 Pro'yu kararlı bir REST yüzeyinin arkasında sunar — sağlayıcı kimlik bilgilerini kendin yönetmeden normalize edilmiş auth, faturalandırma ve yanıtlarla modelin tam kapasitesini alırsın.
Metin-görsel için boş image_urls dizisi. Referansları düzenlemek veya birleştirmek için 1–10 genel HTTPS görsel URL'si — aynı uç nokta iki modu da yönetir.
1:1, 4:3, 3:4, 16:9, 9:16, 2:3 ve 3:2. Yerleşimine uyan oranı seç — model kırpmak yerine o oranda doğal olarak kompoze eder.
1K görsel başına 9 kredi, 2K başına 18. Referans düzenleme ilk görselden sonra her biri +0.8 kredi ekler. estimated_credits sorgulamadan önce görünür.
Tipik 1K görevler yaklaşık 15–25 saniye sürer; 2K ve çok referanslı düzenlemeler daha uzun. Durum uç noktasını sorgula — görevler tasarım gereği asenkron.
Hayır — çağırmamalısın da. Bearer anahtarını backend'de tut, uç noktalarımızı sunucu tarafından çağır ve istemcilere yalnızca kendi güvenli rotalarını aç.
Evet — çok dilli görsel içi metin güçlü yanlarından biri: posterler, fiyat etiketleri ve yerelleştirilmiş reklam kreatifleri okunabilir metinle çıkar.
Tam istek şeması, yanıt örnekleri, hata tablosu ve fiyat detayları /docs/images içinde. Bu sayfa entegrasyon genel bakışıdır.
API anahtarı al, ilk üretim görevini gönder ve bugün amiral gemisi görsel üretimini ürününe bağla.