Dokumentasi

Sample arah Deep Glass. Konten contoh, bukan produk final. · Sample arah: A · B · C · Indeks sample

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.