API 레퍼런스

잔액

GET/v1/balance

계정 잔액과 호출한 API 키로 아직 쓸 수 있는 금액을 USD로 반환합니다. 무료 읽기 전용: 모델을 호출하지 않고 과금도 없습니다. 한도를 다 썼거나 만료된 키도 호출할 수 있으며, 비활성화된 키만 거부됩니다.

#요청 파라미터

Authorizationheader필수
Bearer sk-YOUR_KEY. 본문과 쿼리 파라미터는 없습니다.

balance는 계정 전체 지갑 잔액이며, 큰 작업이 정산된 뒤에는 0 아래로 내려갈 수 있습니다. available은 이 키로 지금 쓸 수 있는 금액으로, balance와 키 자체의 남은 한도 중 작은 값이며 0 미만이 되지 않습니다. 키에 자체 한도가 없으면 key.remaining은 null이고, expires_at이 0이면 만료되지 않습니다.

B2B 호출자는 작업을 보내기 전에 이 값을 조회하고, available이 부족해지면 팀에 알릴 수 있습니다. 요청 서명이 켜져 있다면 해당 키의 다른 호출과 마찬가지로 /v1/balance 경로로 서명하세요.

#관련 오류

401키가 없거나 유효하지 않거나 비활성화되었습니다 — 또는 요청 서명이 켜진 상태에서 서명이 없거나 틀렸습니다.
403계정이 비활성화되었습니다.
500잔액을 읽을 수 없습니다. 몇 초 후 다시 시도하세요.

전체 오류 코드 표 →

#요청 예시

curl https://www.aisplice.store/v1/balance \
  -H "Authorization: Bearer sk-YOUR_KEY"

#응답

response.json

{
  "object": "balance",
  "currency": "USD",
  "balance": 12.5,
  "available": 2,
  "key": {
    "name": "app",
    "unlimited": false,
    "remaining": 2,
    "used": 1,
    "expires_at": 0
  }
}

아직 해결되지 않았나요?

요청 ID나 오류 메시지를 보내 주시면 확인해 드리겠습니다.

이전파일 업로드 정책 다음모델 목록