Uç noktalar

Bakiye ve anahtar bilgisi

GET /credits ve GET /key ile USD bakiyenizi, toplam harcamanızı ve çağıran anahtarın hız limitini okuyun; bakiye bitmeden uyarı almayı öğrenin.

Hesabınızın USD bakiyesini, toplam harcamanızı ve çağıran anahtarın hız limitini okuyun. İki yol aynı gövdeyi döndürür: /credits ve daha kısa takma adı olan /key.

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

Tüm tutarlar ABD doları cinsindendir.

İstek

Parametre yoktur. API anahtarınızla kimlik doğrulayın:

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

Yanıt

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

Alan	Açıklama
`total_credits`	Hesaba bugüne kadar eklenen toplam USD: bakiye yüklemeleri, abonelikle gelen kullanım, bonuslar ve promosyon kodları.
`total_usage`	İsteklere harcanan toplam USD.
`balance_usd`	Harcanabilir güncel bakiye (USD).
`key_id`	Bu istekte kullanılan API anahtarının kimliği.
`rate_limit.requests`	Anahtarın kendi dakikalık istek limiti; anahtar planınızın limitini kullanıyorsa `null`.
`rate_limit.interval`	Her zaman `1m`.

total_credits - total_usage değeri, iadeler ve manuel düzeltmeler nedeniyle balance_usd değerinden biraz farklı olabilir; geçerli olan balance_usd değeridir.

Örnek: bakiye bitmeden durun

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'

Bakiye 0 USD'ye düştüğünde

Faturalandırma sayfasında otomatik yükleme açık değilse, bakiye ekleyene kadar ücretli istekler 402 insufficient_balance döndürür. /credits, /key ve /models okumaları çalışmaya devam eder. Bkz. Fiyatlandırma ve faturalandırma.

Hatalar

Durum	Kod	Ne zaman
401	`invalid_api_key`	Anahtar eksik veya geçersiz.

Bkz. Hatalar.