Dokumentasi
Ringkas dan apa adanya. Semua request memakai header Authorization: Bearer nice-... dan Idempotency-Key untuk operasi yang menyentuh saldo.
Mulai cepat
curl https://api.nicetokens.xyz/v1/chat/completions \
-H "Authorization: Bearer nice-KUNCIMU" \
-H "Idempotency-Key: contoh-1" \
-H "Content-Type: application/json" \
-d '{"model":"deepseek-v4-flash",
"messages":[{"role":"user","content":"Halo"}]}'Ganti nice-KUNCIMU dengan API key dari dashboard. Kunci asli diawali nice-.
Streaming
Tambahkan "stream": true untuk memakai server-sent events dengan format yang sama seperti OpenAI. Setelah potongan pertama terkirim, stream tidak akan diulang otomatis oleh server; aplikasi kamu yang menentukan kebijakan ulang.
Perhitungan biaya
Biaya dihitung dari token aktual: (token masukan / 1.000.000 x tarif masukan) + (token keluaran / 1.000.000 x tarif keluaran). Saldo direservasi sebelum request jalan dan diselesaikan setelah pemakaian diketahui. Kalau pemakaian tidak bisa dipastikan, dananya ditahan untuk rekonsiliasi, bukan ditebak.
Endpoint
| Metode | Path | Keterangan |
|---|---|---|
| GET | /v1/models | Daftar 35 model beserta harga dan kapabilitas publik. |
| POST | /v1/chat/completions | Format OpenAI Chat Completions, unary dan streaming SSE. |
| POST | /v1/responses | Format OpenAI Responses. |
| POST | /v1/messages | Format Anthropic Messages. |
| GET | /v1/balance | Saldo dompet untuk API key yang dipakai. |
| GET | /v1/usage | Pemakaian token per model untuk API key yang dipakai. |
| POST | /v1/messages/count_tokens | Kontrak tersedia. Belum ada model yang terverifikasi untuk endpoint ini. |
Kode error
| Kode | Arti |
|---|---|
invalid_api_key | API key salah atau tidak dikirim. |
model_not_found | Model tidak ada di katalog. |
capability_not_supported | Model tidak mendukung fitur yang diminta. |
insufficient_balance | Saldo tidak cukup untuk reservasi. |
rate_limited | Terlalu banyak permintaan. Coba lagi sebentar. |
upstream_timeout | Permintaan melewati batas waktu 120 detik. |
upstream_error | Gangguan di sisi layanan model. Tidak ada tagihan untuk permintaan yang gagal total. |