GET /v1/balance
API 키를 소유한 계정의 잔액과 해당 키의 지출 한도별 남은 금액을 반환합니다. 앱에 남은 크레딧을 표시하거나, 배치 작업 도중 크레딧이 바닥나기 전에 충전하거나, 에이전트가 402 오류를 만나기 전에 일시 중지하는 데 활용하세요.
자리 표시자:
$API_BASE는https://api.abliteratedllm.dev/v1,$API_ORIGIN은https://api.abliteratedllm.dev,$YOUR_KEY는 발급받은 API 키입니다.
bash
curl $API_BASE/balance -H "Authorization: Bearer $YOUR_KEY"json
{
"balance_usd": "12.345678",
"held_usd": "0.000000",
"trial": false,
"available_usd": "12.345678",
"key_daily_remaining_usd": "4.500000",
"key_monthly_remaining_usd": null,
"key_lifetime_remaining_usd": "40.000000"
}필드
| 필드 | 의미 |
|---|---|
balance_usd | 새 요청에 사용할 수 있는 크레딧(USD, 소수점 이하 6자리). 실행 중인 요청이 임시 차감한 크레딧은 이미 빠져 있습니다. |
held_usd | 아직 실행 중인 요청이 확보해 둔 크레딧. 각 요청이 끝나면 임시 차감액에서 실제 비용을 뺀 금액이 잔액으로 돌아갑니다. |
trial | 계정의 첫 충전이 반영될 때까지 true. 체험 계정에는 더 엄격한 한도가 적용됩니다. |
available_usd | 계정 크레딧에서 실행 중인 요청의 임시 차감액을 뺀 금액. 임시 차감액은 차감되는 즉시 잔액에서 빠지므로 이 값은 항상 balance_usd와 같습니다. 계정의 모든 키가 이 금액을 공유하며, 키의 한도에 따라 더 제한될 수 있습니다(아래 필드). |
key_daily_remaining_usd | 오늘(UTC) 이 키의 일일 한도 중 남은 금액. 키에 일일 한도가 없으면 null. |
key_monthly_remaining_usd | 이번 역월(UTC) 이 키의 월간 한도 중 남은 금액. 한도가 없으면 null. |
key_lifetime_remaining_usd | 이 키의 누적 예산 중 남은 금액. 예산이 없으면 null. |
금액은 정밀도 손실이 없도록 10진수 문자열로 제공됩니다. 부동소수점이 아닌 10진수로 파싱하세요.
참고 사항
balance_usd값은 0보다 약간 낮아질 수 있습니다. 요청은 실제 사용량이 임시 차감액을 넘더라도 항상 실제 사용량대로 과금되기 때문입니다. 잔액이 다음 요청의 임시 차감액보다 적은 동안에는 충전할 때까지 요청이 402insufficient_balance오류로 실패합니다.- 실행 중인 요청이 없으면
held_usd값은 보통"0.000000"입니다. 끝나지 않은 요청의 임시 차감은 15분 후 자동으로 해제됩니다. - 한도의 남은 금액은 한도에서 해당 기간의 키 확정 사용 금액과 실행 중인 요청의 임시 차감액을 뺀 값으로, 게이트웨이가 요청을 전달하기 전에 확인하는 합계와 같습니다. 0 아래로는 내려가지 않습니다. 요청 자체의 임시 차감액이 남은 금액 안에 들어가지 않으면 요청은 402
key_spend_cap_reached오류로 실패하므로, 남은 금액이 적으면 출력 예산이 큰 요청은 거부될 수 있습니다. 인증을 참고하세요. - 지출 한도는 키별로 적용되며 잔액을 바꾸지 않습니다. 각 키는 자신의 한도를 보고하며, 잔액은 계정의 모든 키가 공유합니다.
- 충전은 결제에서 하세요. 크레딧은 만료되지 않습니다.