Referans

POST /v1/images/generations

Metin istemiyle OpenAI biçiminde resim üret: SDK'nın images.generate çağrısı yalnızca temel URL değiştirilerek çalışır. Resimler yanıtın içinde döner ve biz kopyasını tutmayız.

6 Kasım 2026 tarihinde kontrol edildi

Bir resim üret

import base64
import os
from openai import OpenAI

client = OpenAI(
    base_url="https://nokeep.ai/v1",
    api_key=os.environ["NOKEEP_API_KEY"],
)

result = client.images.generate(
    model="z-image-turbo",
    prompt="A lighthouse on a rocky coast at dusk",
    size="1024x1024",
)

with open("picture.webp", "wb") as f:
    f.write(base64.b64decode(result.data[0].b64_json))

Modeller

Model	En iyi kullanım	Resim başına	Boyut	En uzun prompt
chroma	Uzun ve ayrıntılı prompt'ları okuyan açık bir model.	0,03 $	Kenarı en fazla 1280 piksel, 1,5 kat olarak döner	7.500 karakter
z-image-turbo	Buradaki en hızlı model; fotoğraf tarzı resimleri çok sayıda üretmek için.	0,03 $	Kenarı en fazla 1280 piksel	7.500 karakter
wai-illustrious	Anime ve illüstrasyon.	0,03 $	Kenarı en fazla 1280 piksel	1.500 karakter
krea-2-turbo	Bilinen karakterleri ve bir ev stilini korur; 1K ya da 2K.	0,08 $ (1K), 0,12 $ (2K)	1:1, 3:2, 16:9, 21:9, 9:16, 2:3, 3:4, 4:5	5.000 karakter

GET /v1/models aynı fiyatları ve sınırları listeler.

İstek

Alan	Alır	Ne yapar
`model`	Zorunlu	Yukarıdaki model kimliklerinden biri.
`prompt`	Zorunlu	Ne çizileceği; modele olduğu gibi gönderilir. Modelin sınırını aşan reddedilir, asla kesilmez.
`size`	`WIDTHxHEIGHT` ya da `auto`	Resmin boyutu. Varsayılan 1024x1024. Bkz. Boyutlar.
`aspect_ratio`	1:1, 3:2, 2:3, 4:3, 3:4, 4:5, 16:9, 9:16, 21:9	`size` yerine bir biçim. İkisi de gönderilirse bu kazanır.
`n`	1 ile 4 arası	Kaç resim. Yalnızca geri gelenlerin parasını ödersin.
`response_format`	`b64_json` ya da `url`	Varsayılan `b64_json`. `url` saklanan bir dosyaya bağlantı değil, bir `data:` URL'si döndürür.
`output_format`	`webp`, `png` ya da `jpeg`	Varsayılan `webp`.
`resolution`	`1K` ya da `2K`	Yalnızca `krea-2-turbo` için ve fiyatı buna göre belirlenir.
`seed`	Tam sayı	Aynı seed ve prompt benzer bir resim verir. `n` ile her resim seed'e bir ekler.
`negative_prompt`	Metin	Dışarıda bırakılacaklar. Sert sınır kontrolü tarafından okunmaz ve her model bunu dikkate almaz.
`steps`	1 ile 50 arası	Daha fazla adım daha uzun sürer. Her model bunu kullanmaz.
`cfg_scale`	0'dan büyük, 20'ye kadar	Prompt'a ne kadar sıkı uyulacağı. Her model bunu kullanmaz.

quality, style ya da user gibi diğer alanlar atılır ve x-nokeep-ignored başlığında adlarıyla belirtilir. image gibi bir resim taşıyan alan 400 unsupported_input ile reddedilir: bu modeller yalnızca metinle çalışır.

Boyutlar

Bir kenar en az 256 piksel olabilir; uzun kenar, kısa kenarın en fazla üç katı olabilir. Bunun dışı 400 unsupported_size verir.
Daha büyük bir boyut, biçimini koruyarak en çok 1280 piksel kenara sığdırılır. Örneğin OpenAI'nin 1536x1024'ü 1280x848 olarak çizilir.
chroma, çizdiği pikselin 1,5 katını ek ücret olmadan döndürür; yani 1024x1024, 1536x1536 olarak gelir.
krea-2-turbo adlandırılmış biçimlerle çizer; bu yüzden bir size en yakın biçime dönüşür.
Yanıttaki size ya da aspect_ratio her zaman ne aldığını söyler.

Yanıt

JSON

{
  "created": 1793960000,
  "data": [
    {
      "b64_json": "UklGRk…"
    }
  ],
  "model": "z-image-turbo",
  "output_format": "webp",
  "size": "1024x1024",
  "usage": {
    "images": 1,
    "nokeep_credits": 30
  }
}

x-nokeep-credits ve x-nokeep-balance başlıkları çağrının ne tuttuğunu ve ne kaldığını söyler; sohbette olduğu gibi. Bir resim geri geldiğinde ücretlendirilir. Başarısız ya da reddedilen bir resim ücretlendirilmez.

Modellerin ne üreteceği

Yetişkin içerik, sağlayıcının sansürsüz olarak işaretlediği modellerde kapsamdadır. z-image-turbo bunlardan biri değildir ve kontrollerimizde en çok geri çeken odur; bu yüzden istenenden daha yumuşak gelebilir.

Dört sert sınır geçerli kalır: reşit olmayanları içeren cinsel içerik, gerçek kişilerin cinsel içeriği, kitlesel ölüme yol açan zarar ve gerçek bir kişiyi hedef alma. Bunlardan birini aşan prompt 422 hard_limit alır ve ücretlendirilmez. Kontrol prompt'u okur; bkz. Sert sınırlar. Modelin barındırıcısı bir isteği ya da sonucu geri de çekebilir: bu 422 content_refused olur, o da ücretsizdir.

Sınırlar ve hatalar

Bir anahtar dakikada 60 resim isteği yapabilir; bu, toplam 120 istek sınırı içindedir. Bunun ötesi Retry-After ile birlikte 429 rate_limited döner. Hatalar sayfası her kodu listeler.

Kodunu hiçbir şey harcamadan denemek için anahtar olarak sk-nokeep-test gönder. Yukarıdaki her kontrolü çalıştırır ve tek piksellik bir resimle yanıt verir.

curl

curl https://nokeep.ai/v1/images/generations \
  -H "Authorization: Bearer $NOKEEP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "chroma",
  "prompt": "A lighthouse on a rocky coast at dusk",
  "n": 2,
  "aspect_ratio": "16:9",
  "output_format": "png",
  "seed": 42
}'

API anahtarı al Ücretsiz test anahtarını dene: sk-nokeep-test