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

Documentation Index

Fetch the complete documentation index at: https://docs.k-router.com/llms.txt

Use this file to discover all available pages before exploring further.

​
GET /v1/usage

인증된 사용자의 잔여 한도(USD)와 사용량을 조회합니다.

​
헤더

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

​
응답

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

​
응답 필드

필드타입설명
credits_remainingnumber잔여 한도 (USD)
credits_usednumber총 사용 금액 (USD)
usage_this_monthnumber이번 달 사용 금액 (USD)
recentUsagearray최근 50건 사용 내역
모든 금액은 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']}")