Seedream 5 Görsel API
API Dokümantasyonu
Bu uç noktalarla Seedream 5 görsellerini eşzamansız üretin. Kredi tüketimi kaliteye ve moda göre değişir.
Kimlik Doğrulama
Tüm istekler, API anahtarınızı Authorization header:
Authorization: Bearer <YOUR_API_KEY>Eksik veya geçersiz anahtarlar şunu döndürür 401 Unauthorized.
POST
https://seedream45ai.org/api/generate
Üretim görevi oluştur
Yeni bir Seedream 5 işi gönderir. Çağrı, oluşturma işlemi asenkron olarak tamamlanırken hemen bir task_id döndürür.
| Parametre | Tür | Gerekli | Açıklama |
|---|---|---|---|
| prompt | string (max 1500 chars) | Evet | Ana metin açıklaması (en fazla 1500 karakter). Her istek için zorunludur. |
| aspectRatio | string | Evet | Desteklenen oranlar: 1:1 · 3:4 · 4:3 · 9:16 · 16:9. |
| quality | string (basic | high) | Evet | basic (hızlı, 2K) veya high (daha ayrıntılı, 4K). |
| imageUrls | string[] | Hayır | İsteğe bağlı referans görseller. Düzenleme modunda zorunludur. |
Kredi Tüketimi
Krediler, görev oluşturulduğunda düşülür. Başarısız işler otomatik olarak iade edilir.
| Ön Ayar | Düşülen Krediler |
|---|---|
| Metinden görsele · Basic | 12 |
| Metinden görsele · High | 18 |
| Referansla düzenleme · Basic | 18 |
| Referansla düzenleme · High | 24 |
| 4 görsellik seri (tek çağrı) | 48 |
Örnek istek
POST https://seedream45ai.org/api/generate
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json
{
"prompt": "Cinematic photo of an obsidian smartwatch on a marble plinth, volumetric lighting",
"aspectRatio": "4:3",
"quality": "high",
"imageUrls": []
}Örnek yanıt
{
"code": 200,
"message": "success",
"data": {
"task_id": "sd5_b83bf7c0c51a4c71"
}
}GET / POST
https://seedream45ai.org/api/status
Görev durumunu kontrol et
En son kaydı sorgulamak için bu uç noktayı kullanın. Görev hala IN_PROGRESS durumundayken, yanıt vermeden önce sağlayıcıyı bir kez daha sorgularız.
| Parametre | Tür | Gerekli | Açıklama |
|---|---|---|---|
| task_id | string | Evet | /generate tarafından döndürülen ID. /status çağrısında sorgu (?task_id=) olarak gönderin. |
| Alan | Açıklama |
|---|---|
| task_id | /generate'den dönen ID. |
| status | SUCCESS (BAŞARILI) |
| request | Gönderilen yükün temizlenmiş kopyası. |
| response | Durum SUCCESS olduğunda medya URL'leri dizisi. |
| consumed_credits | Görev için tahsil edilen krediler (iade edildiğinde 0). |
| error_message | Durum FAILED olduğunda sağlayıcı hatası. |
| created_at | İşin saklandığı UTC zaman damgası. |
Örnek istek
GET https://seedream45ai.org/api/status?task_id=sd5_b83bf7c0c51a4c71
Authorization: Bearer <YOUR_API_KEY>Örnek yanıt
{
"code": 200,
"message": "success",
"data": {
"task_id": "sd5_b83bf7c0c51a4c71",
"status": "SUCCESS",
"request": {
"prompt": "Cinematic photo of an obsidian smartwatch on a marble plinth, volumetric lighting",
"aspectRatio": "4:3",
"quality": "high"
},
"response": [
"https://watch_001.png"
],
"consumed_credits": 12,
"error_message": null,
"created_at": "2025-06-14T05:21:11Z"
}
}Hata Yönetimi
401 Unauthorized- Eksik veya geçersiz API anahtarı.402 Payment Required- Kredi bakiyesi düşülen tutarı karşılayamadı.429 Too Many Requests- Sorgulama sıklığını veya istek hızını azaltın.500- Geçici sorun; üstel geri çekilme ile yeniden deneyin.