Credits API
API 키에 연결된 계정의 크레딧 잔액을 조회합니다.
월별 할당 크레딧, 충전 크레딧, 전체 합계를 확인할 수 있어 외부 도구(Obsidian, OpenClaw 등)에서 사용량을 모니터링할 수 있습니다.
크레딧 잔액 조회
GET
/v1/gateway/credits/인증된 사용자의 크레딧 잔액 정보를 반환합니다. 별도의 파라미터 없이 API 키만으로 조회할 수 있습니다.
요청 헤더
파라미터
파라미터 없음. API 키로 사용자를 자동 식별합니다.
응답
object
항상 string
"credit_balance".monthly_allocated
월별 할당 크레딧 정보.object
quota
월별 할당량.float
used
이번 달 사용량.float
remaining
남은 크레딧 (float
quota - used).renewal_date
다음 갱신일 (ISO 8601). 매월 1일에 리셋됩니다.string | null
purchased
충전(구매) 크레딧 정보.object
quota
총 충전 크레딧.float
used
사용한 충전 크레딧.float
remaining
남은 충전 크레딧.float
total
전체 합계 (월별 + 충전).object
quota
전체 할당량.float
used
전체 사용량.float
remaining
전체 남은 크레딧.float
응답 예시
코드 예제
Python
curl
다음 단계
마지막 수정 날짜: Apr 07, 2026
