switch_heading
/v1/imagesGörüntü oluşturma API'si
Seedream 5 Pro ile metinden görüntü üretin veya en fazla on referans görüntüyü düzenleyin.
Model takma adı
seedream-5-pro
Girdi modları
Metin veya referans
Temel fiyat
9 / 18 credits
Hızlı başlangıç
Bir görev oluşturun ve SUCCESS veya FAILED olana kadar durumu sorgulayın.
| 1 | curl -X POST 'https://seedanceapi.org/v1/images/generations' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' \ |
| 3 | -H 'Content-Type: application/json' \ |
| 4 | -d '{ |
| 5 | "model": "seedream-5-pro", |
| 6 | "prompt": "A cinematic product photo on a reflective surface", |
| 7 | "aspect_ratio": "1:1", |
| 8 | "resolution": "1k", |
| 9 | "image_urls": [] |
| 10 | }' |
İstek yaşam döngüsü
- 01
Kimlik doğrula
Mevcut Seedance API anahtarını Bearer başlığında kullanın.
- 02
Görev oluştur
Oluşturma isteğini gönderin ve API'nin döndürdüğü task ID'yi saklayın.
- 03
Sonucu sorgula
Task ID ile sorgulayın; başarılı görüntüler CDN adresimizden döner.
Kimlik doğrulama
Tüm uç noktalar Seedance anahtarı gerektirir; sağlayıcı bilgileri gizli kalır.
| 1 | Authorization: Bearer YOUR_API_KEY |
| 2 | Content-Type: application/json |
Fiyatlandırma
Ürün fiyatı sağlayıcı rotasından bağımsızdır.
| Çözünürlük | Temel ücret | Ek referans |
|---|---|---|
| 1K | 9 credits | İkinci görüntüden itibaren her biri +0,8 credits |
| 2K | 18 credits | İkinci görüntüden itibaren her biri +0,8 credits |
Uç noktalar
/v1/images/generationsBoş image_urls metinden üretir; 1–10 URL düzenlemeyi açar.
seedream-5-pro olmalıdır.
En fazla 3000 karakterlik istem.
1:1, 4:3, 3:4, 16:9, 9:16, 2:3 veya 3:2. Defaults to 1:1.
1k veya 2k. Defaults to 1k.
En fazla 10 genel HTTPS URL.
Metinden görüntü isteği
| 1 | { |
| 2 | "model": "seedream-5-pro", |
| 3 | "prompt": "A cinematic product photo on a reflective surface", |
| 4 | "aspect_ratio": "1:1", |
| 5 | "resolution": "1k", |
| 6 | "image_urls": [] |
| 7 | } |
Referans düzenleme
| 1 | { |
| 2 | "model": "seedream-5-pro", |
| 3 | "prompt": "Place this product in a minimal studio scene", |
| 4 | "aspect_ratio": "4:3", |
| 5 | "resolution": "2k", |
| 6 | "image_urls": [ |
| 7 | "https://cdn.example.com/reference.png" |
| 8 | ] |
| 9 | } |
HTTP 202
| 1 | { |
| 2 | "task_id": "n30c6f2...seed", |
| 3 | "status": "IN_PROGRESS", |
| 4 | "model": "seedream-5-pro", |
| 5 | "estimated_credits": 9 |
| 6 | } |
/v1/images/generations/:task_idOluşturma sırasında dönen task ID ile en güncel durumu alın.
| 1 | curl 'https://seedanceapi.org/v1/images/generations/n30c6f2...seed' \ |
| 2 | -H 'Authorization: Bearer YOUR_API_KEY' |
SUCCESS
| 1 | { |
| 2 | "task_id": "n30c6f2...seed", |
| 3 | "status": "SUCCESS", |
| 4 | "model": "seedream-5-pro", |
| 5 | "images": [ |
| 6 | { "url": "https://cdn44.gogloai.com/results/image.png" } |
| 7 | ], |
| 8 | "consumed_credits": 9, |
| 9 | "created_at": "2026-07-13 10:00:00" |
| 10 | } |
FAILED
| 1 | { |
| 2 | "task_id": "n30c6f2...seed", |
| 3 | "status": "FAILED", |
| 4 | "model": "seedream-5-pro", |
| 5 | "consumed_credits": 0, |
| 6 | "error": { |
| 7 | "code": "GENERATION_FAILED", |
| 8 | "message": "Image generation failed." |
| 9 | } |
| 10 | } |
Hatalar
| HTTP | Code | Anlam |
|---|---|---|
| 400 | INVALID_* | Geçersiz istek parametreleri. |
| 401 | INVALID_API_KEY | API anahtarı eksik veya geçersiz. |
| 402 | INSUFFICIENT_CREDITS | Yetersiz credits. |
| 404 | TASK_NOT_FOUND | Görev bulunamadı. |
| 502 / 503 | UPSTREAM_* | Görüntü hizmeti geçici olarak kullanılamıyor. |