엔드포인트

잔액 조회

GET /credits로 계정의 USD 잔액과 누적 사용액을, GET /key로 호출한 키의 속도 제한을 조회하는 방법과 잔액이 $0이 될 때의 동작, 오류 응답을 안내합니다. 잔액이 바닥나기 전에 작업을 중단하는 예시 코드도 있습니다.

계정의 USD 잔액, 누적 사용액, 호출한 키의 속도 제한을 조회합니다. /credits와 더 짧은 별칭인 /key, 두 경로가 동일한 본문을 반환합니다.

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

모든 금액은 미국 달러입니다.

요청

파라미터는 없습니다. API 키로 인증하세요.

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

응답

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

필드	설명
`total_credits`	계정에 지금까지 추가된 총 USD: 충전, 요금제에 포함된 사용량, 보너스, 프로모션 코드.
`total_usage`	요청에 사용한 총 USD.
`balance_usd`	현재 사용 가능한 USD 잔액.
`key_id`	이 요청에 사용한 API 키의 id.
`rate_limit.requests`	해당 키 자체의 분당 요청 수 제한. 키가 요금제의 제한을 따르면 `null`.
`rate_limit.interval`	항상 `1m`.

환불과 수동 조정 때문에 total_credits - total_usage는 balance_usd와 약간 다를 수 있습니다. 기준이 되는 값은 balance_usd입니다.

예시: 잔액이 바닥나기 전에 중단하기

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'

잔액이 $0이 되면

결제 페이지에서 자동 충전을 켜 두지 않았다면, 잔액을 추가할 때까지 유료 요청은 402 insufficient_balance를 반환합니다. /credits, /key, /models 조회는 계속 동작합니다. 요금 및 결제를 참고하세요.

오류

상태	코드	발생 조건
401	`invalid_api_key`	키가 없거나 유효하지 않음.

오류를 참고하세요.