Docs

Documentation

Referensi endpoint OpenAI-compatible: chat, responses, images, videos, models, kuota. Auth Bearer sk-user.

Base URL

https://api.ngawi-proxy.cloud/v1

Auth: header Authorization: Bearer sk-user-... (API key kamu).

Endpoint customer

Method	Path	Ket
GET	/v1/models	daftar model
POST	/v1/chat/completions	chat (disarankan stream=true)
POST	/v1/responses	Responses API
POST	/v1/images/generations	generate gambar
POST	/v1/images/edits	edit gambar
POST	/v1/videos/generations	generate video (async)
GET	/v1/videos/	status job video
GET	/v1/videos//content	unduh video selesai
GET	/api/me	sisa kuota key kamu
GET	/api/me/usage	riwayat pemakaian
GET	/usage	UI cek kuota di browser
GET	/status	status layanan

Quick start · chat

curl https://api.ngawi-proxy.cloud/v1/chat/completions \
    -H "Authorization: Bearer ***" \
    -H "Content-Type: application/json" \
    -d '{"model":"grok-4.5","messages":[{"role":"user","content":"hi"}],"max_tokens":256,"stream":true}'

Plan Multi: ganti model ke deepseek-v4-flash / glm-5.2 (lihat /prices). Plan mengikuti key kamu.

Cek kuota

# JSON
  curl https://api.ngawi-proxy.cloud/api/me \
    -H "Authorization: Bearer ***"

  # riwayat
  curl "https://api.ngawi-proxy.cloud/api/me/usage?limit=20" \
    -H "Authorization: Bearer ***"

  # UI browser
  https://api.ngawi-proxy.cloud/usage

Model · plan Grok

Model	Ket
`grok-4.5`	default chat / reasoning
`grok-4.5-low` · `-medium` · `-high`	alias effort → base + reasoning_effort
`grok-imagine-image`	generate gambar (sync)
`grok-imagine-image-edit` · `-quality`	edit / quality image

Model selection = GET https://api.ngawi-proxy.cloud/v1/models (filter model_allow). Gunakan ID model kanonik dari katalog live. Tidak ada grok-4.3 / 4.20 / chat-fast / build di plan jual ini.

Model · plan Multi

Model	Ket
`deepseek-v4-flash`	paling hemat kuota (×0.5)
`glm-5.2`	standar, seimbang
`deepseek-v4-pro` · `deepseek-v4-mod`	standar / reasoning
`gpt-5.5` · `gpt-5.6` family	kelas menengah
`claude-sonnet-5` · opus	boros kuota

Daftar penuh + multiplier: /prices. Multi tidak include image/video Grok.

Quick start · image

curl https://api.ngawi-proxy.cloud/v1/images/generations \
    -H "Authorization: Bearer ***" \
    -H "Content-Type: application/json" \
    -d '{"model":"grok-imagine-image","prompt":"quiet desk lamp, soft light","n":1}'

Plan Grok. Model image juga ada di GET /v1/models.

Tips supaya lancar

1) Pakai stream=true (paling stabil untuk agent / chat panjang)
  2) Set client timeout 300–600 detik (jangan 30s)
  3) Jangan spam retry 3× saat request masih jalan
  4) Prompt / history sangat besar + high = lebih lama (normal)
  5) Model selection: GET /v1/models (sumber kebenaran)
  6) Cek sisa kuota di /usage atau GET /api/me

Error yang mungkin muncul

401 — API key salah, nonaktif, atau expired
402 / 403 — kuota habis (hubungi admin untuk top-up)
429 — rate limit; tunggu sebentar lalu coba lagi
502 — layanan hulu sibuk; coba lagi dengan jeda
timeout di client — naikkan timeout / aktifkan stream

Keamanan key

Jangan share API key di chat publik / repo. Simpan key di tempat aman. Secret full hanya ditampilkan saat key dibuat.