Referensi

POST /v1/images/generations

Buat gambar dari prompt teks, dengan format OpenAI: images.generate dari SDK cukup diganti base URL-nya. Gambar dikembalikan dalam respons, dan kami tidak menyimpan salinannya.

Diperiksa 6 November 2026

Buat gambar

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))

Model

Model	Cocok untuk	Per gambar	Ukuran	Prompt terpanjang
chroma	Model terbuka yang membaca prompt panjang dan detail.	$0,03	Hingga 1.280 piksel per sisi, dikembalikan pada 1,5x	7.500 karakter
z-image-turbo	Tercepat di sini, untuk gambar fotografis dalam jumlah banyak.	$0,03	Hingga 1.280 piksel per sisi	7.500 karakter
wai-illustrious	Anime dan ilustrasi.	$0,03	Hingga 1.280 piksel per sisi	1.500 karakter
krea-2-turbo	Menjaga karakter yang dikenal dan gaya khas, pada 1K atau 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 mencantumkan harga dan batas yang sama.

Permintaan

Field	Diisi dengan	Fungsinya
`model`	Wajib	Salah satu id model di atas.
`prompt`	Wajib	Apa yang digambar, dikirim ke model apa adanya. Di atas batas model ditolak, tidak pernah dipotong.
`size`	`WIDTHxHEIGHT` atau `auto`	Ukuran gambar. Default-nya 1024x1024. Lihat Ukuran.
`aspect_ratio`	1:1, 3:2, 2:3, 4:3, 3:4, 4:5, 16:9, 9:16, 21:9	Bentuk, sebagai pengganti `size`. Jika keduanya dikirim, ini yang dipakai.
`n`	1 sampai 4	Berapa gambar. Kamu hanya membayar yang kembali.
`response_format`	`b64_json` atau `url`	Default-nya `b64_json`. `url` mengembalikan URL `data:`, bukan tautan ke file tersimpan.
`output_format`	`webp`, `png` atau `jpeg`	Default-nya `webp`.
`resolution`	`1K` atau `2K`	Hanya `krea-2-turbo`, dan harganya mengikuti ini.
`seed`	Bilangan bulat	Seed dan prompt yang sama memberi gambar yang mirip. Dengan `n`, setiap gambar menambah satu ke seed.
`negative_prompt`	Teks	Apa yang dihindari. Tidak dibaca oleh pemeriksaan batas keras, dan tidak semua model memperhitungkannya.
`steps`	1 sampai 50	Langkah lebih banyak butuh waktu lebih lama. Tidak semua model memakainya.
`cfg_scale`	Di atas 0, sampai 20	Seberapa ketat mengikuti prompt. Tidak semua model memakainya.

Field lain, seperti quality, style atau user, dibuang dan disebut di header x-nokeep-ignored. Field yang membawa gambar, seperti image, ditolak dengan 400 unsupported_input: model ini hanya bekerja dari teks.

Ukuran

Sisi bisa minimal 256 piksel, dan sisi yang lebih panjang tidak lebih dari tiga kali sisi yang lebih pendek. Di luar itu adalah 400 unsupported_size.
Ukuran yang lebih besar dipas ke dalam 1.280 piksel per sisi, dengan bentuknya dijaga. Misalnya 1536x1024 dari OpenAI digambar sebagai 1280x848.
chroma mengembalikan 1,5x piksel yang ia gambar, tanpa biaya tambahan, jadi 1024x1024 kembali sebagai 1536x1536.
krea-2-turbo menggambar dalam bentuk bernama, jadi size menjadi bentuk terdekat.
size dan aspect_ratio pada respons selalu menyebut apa yang kamu dapat.

Respons

JSON

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

Header x-nokeep-credits dan x-nokeep-balance menyebut berapa biaya panggilan dan apa yang tersisa, seperti pada chat. Gambar ditagih saat kembali. Gambar yang gagal atau ditolak tidak dikenai biaya.

Apa yang dibuat model

Konten dewasa termasuk pada model yang ditandai tanpa sensor oleh host. z-image-turbo bukan salah satunya, dan ia paling banyak menahan diri dalam pemeriksaan kami, jadi hasilnya bisa lebih lembut dari yang diminta.

Empat batas keras tetap berlaku: konten seksual yang melibatkan anak di bawah umur, konten seksual tentang orang sungguhan, bahaya korban massal dan menargetkan orang sungguhan. Prompt yang melewati salah satunya mendapat 422 hard_limit dan tidak dikenai biaya. Pemeriksaan membaca prompt; lihat Batas keras. Host model juga bisa menolak permintaan atau menahan hasil: itu 422 content_refused, juga gratis.

Batas dan error

Sebuah kunci bisa membuat 60 permintaan gambar per menit, di dalam 120 permintaan secara keseluruhan. Lebih dari itu adalah 429 rate_limited dengan Retry-After. Halaman error mencantumkan setiap kode.

Untuk mengecek kodemu tanpa mengeluarkan apa pun, kirim sk-nokeep-test sebagai kunci. Kunci itu menjalankan setiap pemeriksaan di atas dan menjawab dengan gambar satu piksel.

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
}'

Dapatkan kunci API Coba kunci uji gratis: sk-nokeep-test