Geliştirici referansı

Seedream 5 Pro API belgeleri

Bu sitenin eşzamansız API'siyle Seedream 5 Pro görselleri oluşturun. Seedream 5.5 hâlâ önizleme aşamasındadır ve burada henüz çağrılamaz.

Hızlı başlangıç

  1. Çalışma alanının API anahtarları bölümünde bir anahtar oluşturun.
  2. POST /api/v1/images/generate adresine model=seedream-5-pro ve bir istem gönderin.
  3. Dönen data.task_id ve aynı API anahtarıyla GET /api/v1/images/status?task_id=TASK_ID adresini düzenli sorgulayın.

Kimlik doğrulama

Sunucunuzdan Authorization: Bearer YOUR_API_KEY gönderin. Tarayıcı oturumu veya Cookie gerekmez. API anahtarınızı gizli tutun.

Authorization: Bearer YOUR_API_KEY

Uç noktalar ve istek alanları

POST /api/v1/images/generate

model, prompt, aspect_ratio ve resolution (1k veya 2k) içeren bir JSON gövdesi gönderin. İsteğe bağlı image_urls en fazla 10 referans görsel URL'si kabul eder; public isteğe bağlı bir mantıksal değerdir. Yanıt code, message ve task_id ile status içeren data alanını döndürür.

GET /api/v1/images/status?task_id=TASK_ID

task_id ile sorgulama; code, message ve task_id, status, consumed_credits, image_urls (görsel URL'leri dizisi) içeren data alanını döndürür. Görev başarısız olursa error_message bulunabilir.

Çağrılabilen tek model: seedream-5-pro

Görev işlenirken sorgulamayı sürdürün; tamamlandığında image_urls, başarısız olduğunda error_message alanını okuyun.

cURL örneği

Komutları terminalinize kopyalayın, YOUR_API_KEY yerine gizli API anahtarınızı ve TASK_ID yerine ilk yanıttaki data.task_id değerini yazın.

curl -X POST https://seedream5-5ai.com/api/v1/images/generate -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' --data '{"model":"seedream-5-pro","prompt":"Net ve okunaklı yazıları olan bir kafe posteri","aspect_ratio":"1:1","resolution":"1k","image_urls":[],"public":false}'

curl 'https://seedream5-5ai.com/api/v1/images/status?task_id=TASK_ID' -H 'Authorization: Bearer YOUR_API_KEY'