Seedream 5 Pro API rehberi

AI görsel üretimi için Seedream 5 Pro API

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.

Çözünürlük
1K / 2K

1K veya 2K çıktı

En-boy oranları
7

1:1'den 16:9, 9:16, 2:3, 3:2'ye

Girdiler
T2I + I2I

Prompt veya 10'a kadar referans görsel

Arayüz
REST

HTTPS üzerinden JSON

Başlangıç isteği

Seedream 5 Pro görsel görevi oluştur

seedream-5-pro
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.

Neden Seedream 5 Pro API'yi entegre etmelisin

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.

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.

Tek kararlı model takma adı

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.

Öngörülebilir kredi fiyatlandırması

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.

Seedream 5 Pro API yetenekleri

Herkese açık yüzey, modelin gerçekten yaptığını sunar: metin-görsel üretimi ve ona kadar referans görselle düzenleme.

Metin-görsel üretimi

En-boy oranı ve çözünürlükle 3000 karaktere kadar prompt gönder — kompozisyon, ışık ve görsel içi tipografiyi model halleder.

Çok referanslı düzenleme

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.

2K yüksek çözünürlüklü çıktı

resolution'ı "2k" yaparak baskı kalitesinde renderlar ve son varlıklar al. 1K önizlemeler ve iterasyonlar için yeterli.

Çok dilli görsel içi metin

Modelin en güçlü yanlarından biri — poster ve tabelalarda İngilizce, Çince, Japonca ve daha fazlasıyla okunabilir metin.

Asenkron görev mimarisi

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.

Sağlayıcıdan bağımsız yanıtlar

Upstream yönlendirmesi ne olursa olsun yanıt formatı sabit kalır — consumed_credits, status ve görsel URL'leri normalize edilir.

Seedream 5 Pro API nasıl çağrılır

API anahtarından hazır görsel URL'sine üç adım.

1

API anahtarı oluştur

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.

2

Üretim görevi gönder

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.

3

Sorgula ve render et

GET /v1/images/generations/:task_id çağır. status SUCCESS olduğunda images[0].url'yi oku ve sonucu göster veya arşivle.

Uç nokta referansı

İki uç nokta tüm yaşam döngüsünü kapsar — oluştur ve sorgula.

POST /v1/images/generations

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.

GET /v1/images/generations/:task_id

IN_PROGRESS, images[].url içeren SUCCESS veya hata nesneli FAILED döndürür. Tamamlandığında consumed_credits'i de bildirir.

Hatalar ve limitler

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.

İstek parametreleri

ParametreDeğer
model"seedream-5-pro" olmalı — bu rotadaki tek genel model.
promptMetin prompt'u veya düzenleme talimatı, 1–3000 karakter.
aspect_ratio1: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_urls0–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.

Kredi fiyatlandırması

Seedance API kredileriyle görsel başına sabit fiyat. Oluşturma yanıtı estimated_credits içerir; tamamlanan durum consumed_credits bildirir.

ModKredilerNotlar
Metin-görsel · 1K9 kredi / görselVarsayılan çözünürlük — iterasyonlar ve önizlemeler için.
Metin-görsel · 2K18 kredi / görselSon varlıklar için baskı kalitesi çıktı.
Referans düzenlemeEk görsel başına +0.8 krediİlk referans temel fiyata dahil; 2–10. görseller her biri +0.8.

Seedream 5 Pro API SSS

Seedance API'de Seedream 5 Pro API'yi değerlendiren geliştiriciler için yanıtlar.

Bu resmi ByteDance Seedream 5 Pro API'si mi?

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 ile referans düzenleme arasındaki fark ne?

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.

Seedream 5 Pro hangi en-boy oranlarını destekliyor?

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.

Bir Seedream 5 Pro görseli kaç kredi?

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.

Bir üretim ne kadar sürer?

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.

Bu API'yi tarayıcıdan çağırabilir miyim?

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ç.

Seedream 5 Pro görsellerin içine metin render edebiliyor mu?

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 API dokümantasyonu nerede?

Tam istek şeması, yanıt örnekleri, hata tablosu ve fiyat detayları /docs/images içinde. Bu sayfa entegrasyon genel bakışıdır.

İlk Seedream 5 Pro görselini oluştur

API anahtarı al, ilk üretim görevini gönder ve bugün amiral gemisi görsel üretimini ürününe bağla.