Endpoint

Saldo dan info key

Baca saldo USD, total pengeluaran, dan batas laju API key Anda lewat GET /credits dan GET /key, lengkap dengan contoh kode.

Baca saldo USD akun Anda, total pengeluaran, dan batas laju dari key yang dipakai. Dua path mengembalikan body yang sama: /credits dan /key, alias yang lebih singkat.

GET https://api14.com/api/v1/credits
GET https://api14.com/api/v1/key

Semua jumlah dalam dolar AS.

Request

Tanpa parameter. Autentikasi dengan API key Anda:

curl https://api14.com/api/v1/credits \
  -H "Authorization: Bearer sk-api14-..."

Respons

{
  "data": {
    "total_credits": 145.0,
    "total_usage": 102.82,
    "balance_usd": 42.18,
    "key_id": "ckey_01JABCDEF",
    "rate_limit": { "requests": 120, "interval": "1m" }
  }
}

Field	Deskripsi
`total_credits`	Total USD yang pernah ditambahkan ke akun: top up, pemakaian termasuk langganan, bonus, dan kode promo.
`total_usage`	Total USD yang dibelanjakan untuk request.
`balance_usd`	Saldo USD yang bisa dipakai saat ini.
`key_id`	ID API key yang dipakai untuk request ini.
`rate_limit.requests`	Batas request per menit milik key itu sendiri, atau `null` jika key memakai batas paket Anda.
`rate_limit.interval`	Selalu `1m`.

total_credits - total_usage bisa sedikit berbeda dari balance_usd karena refund dan penyesuaian manual; balance_usd yang menjadi acuan.

Contoh: berhenti sebelum saldo habis

import os, requests

r = requests.get(
    "https://api14.com/api/v1/credits",
    headers={"Authorization": f"Bearer {os.environ['API14_API_KEY']}"},
)
balance = r.json()["data"]["balance_usd"]
if balance < 1:
    raise SystemExit(f"Balance low: ${balance:.2f}. Add funds at /dashboard/billing")

curl -s https://api14.com/api/v1/key \
  -H "Authorization: Bearer $API14_API_KEY" | jq '.data.balance_usd'

Saat saldo mencapai $0

Request berbayar mengembalikan 402 insufficient_balance sampai Anda menambah dana, kecuali top up otomatis diaktifkan di Billing. Membaca /credits, /key, dan /models tetap berfungsi. Lihat Harga dan penagihan.

Error

Status	Kode	Kapan
401	`invalid_api_key`	Key tidak ada atau tidak valid.

Lihat Error.