Skip to main content
GET
/
v1
/
usage
Usage
curl --request GET \
  --url https://api.k-router.com/v1/usage \
  --header 'Authorization: <authorization>'

​
GET /v1/usage

인증된 사용자의 크레딧 잔액과 사용량을 조회합니다.

​
헤더

​
Authorization
string
required
Bearer kr-your-api-key

​
응답

200 - 성공
{
  "credits_remaining": 5000.00,
  "credits_used": 1234.56,
  "usage_this_month": 890.12,
  "customer": {
    "name": "My Company",
    "credits": 5000.00
  },
  "recentUsage": [
    {
      "model": "kr/gpt54",
      "inputTokens": 150,
      "outputTokens": 500,
      "credits": 0.85,
      "createdAt": "2026-03-20T04:00:00.000Z"
    }
  ]
}

​
응답 필드

필드타입설명
credits_remainingnumber남은 크레딧
credits_usednumber총 사용 크레딧
usage_this_monthnumber이번 달 사용 크레딧
recentUsagearray최근 50건 사용 내역
1 크레딧 = $0.001 USD. 크레딧 단위로 표시됩니다.

​
예시

cURL
curl https://api.k-router.com/v1/usage \
  -H "Authorization: Bearer kr-your-api-key"
Python
import requests

r = requests.get(
    "https://api.k-router.com/v1/usage",
    headers={"Authorization": "Bearer kr-your-api-key"}
)
data = r.json()
print(f"남은 크레딧: {data['credits_remaining']}")
print(f"이번 달 사용: {data['usage_this_month']}")