API

Seedream 5.0 Pro API

Görüntü

Seedream 5.0 Pro API, esnek en boy oranları ve 1K veya 2K çıktıyla metinden görsel üretimini ve referans görsellerin düzenlenmesini destekler.

Yetkilendirmeler

Bearerstringheaderzorunlu

İstekleri yetkilendirmek için API anahtarı

Gövde

application/json

modelstringzorunlu

seedream-5-0-pro

input.promptstringzorunlu

Oluşturmak istediğiniz görüntüyü veya referans görüntülerinizde yapmak istediğiniz değişiklikleri açıklayın. Baştaki ve sondaki boşluklar temizlenir.

input.imagesstring[]isteğe bağlı

İsteğe bağlı referans görsel URL’leri. Yalnızca herkese açık HTTPS URL’lerini kullanın. Metinden görsel oluşturmak için bu alanı atlayın.

En fazla 16 öğe.

input.aspect_ratiostringisteğe bağlı

Çıktı görselinin en boy oranı. Varsayılan: 1:1.

Varsayılan: 1:1

1:116:99:163:22:33:44:321:9

input.resolutionstringisteğe bağlı

Görsel çözünürlüğü. Küçük harfli 1k veya 2k değerlerini kullanın. Varsayılan: 1k.

Varsayılan: 1k

1k2k

İstek örnekleri

POST /api/v1/create

curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedream-5-0-pro",
  "input": {
    "prompt": "Fütüristik muz şeklinde bir kameranın sinematik ürün fotoğrafı",
    "aspect_ratio": "1:1",
    "resolution": "1k"
  }
}'

POST /api/v1/create · HTTP 201

{
  "data": {
    "task_id": "task_example",
    "model": "seedream-5-0-pro",
    "status": "processing",
    "credits": 50
  }
}

Görev tamamlanana veya başarısız olana kadar döndürülen görev ID’si ile bu endpoint’i poll edin. En güncel görev durumunu kontrol etmek için her 5 saniyede bir polling yapmanızı öneririz.

POST /api/v1/check

{
  "task_id": "task_example"
}

Yanıt

POST /api/v1/check tarafından döndürülen görev durumu. Aşağıdaki kimlikler, URL’ler ve zaman damgaları örnektir.

idstringzorunlu

data.id içindeki görev kimliği, sorgu isteğinde kullanılan task_id ile aynıdır.

statusstringzorunlu

completed, üretimin başarılı olduğunu ve data.data alanının sonuçları içerdiğini belirtir. Diğer durumlarda data.data null olur.

failed_reasonstringisteğe bağlı

Yalnızca status failed olduğunda hata nedenini açıklamak için döndürülür. completed ve processing durumlarında bu alan bulunmaz.

Tamamlandı · completed

İndirme URL’leri data.data.results içindedir.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "seedream-5-0-pro",
    "status": "completed",
    "data": {
      "results": [
        "https://example.com/generated.png"
      ],
      "processing_time": 18
    }
  }
}

Diğer durumlar

processing veya failed durumunda data.data null olur. Bu örnek failed durumunu gösterir: yalnızca failed, failed_reason içerir. processing için sorgulamaya devam edin; failed için durdurun.

POST /api/v1/check · HTTP 200

{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "seedream-5-0-pro",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

Kredi tüketimi

Tek bir görsel oluşturan isteğin tükettiği kredi miktarı.

Tek bir görsel oluşturan isteğin tükettiği kredi miktarı.
Çözünürlük	1K	2K
Tek görsel	50	100

İsteğe bağlı parametreler belirtilmedi: 50 kredi

İlgili ücreti kullanmak için listelenen input parametrelerini açıkça belirtin. Birden fazla görsel oluşturan istekler daha fazla kredi tüketebilir.

POST /api/v1/create yanıtındaki credits alanı, görev için kesilen kredi miktarını gösterir.