사용자 잔액 조회 API

사용자 잔액 조회 API

API를 호출하기 전에 계정에 잔액이 얼마나 남았는지 확인하고 싶을 때가 있죠. DeepSeek는 현재 사용자 잔액을 조회하는 전용 API를 제공해요. 응답에서 잔액이 충분한지 여부와 통화별 잔액 정보를 함께 받을 수 있어요.

출처: https://api-docs.deepseek.com/api/get-user-balance

엔드포인트는 GET https://api.deepseek.com/user/balance예요. 별도 파라미터 없이 Authorization 헤더에 Bearer 토큰만 넣고 호출하면 돼요.

curl -L -X GET 'https://api.deepseek.com/user/balance' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <TOKEN>'

응답

성공하면 200으로 사용자 잔액 정보를 돌려줘요. 응답은 application/json이며 두 필드로 구성돼요.

  • is_available (boolean) — 사용자 잔액이 API 호출에 충분한지 여부예요.
  • balance_infos (object[]) — 잔액 정보 목록이에요. 통화별로 여러 항목이 올 수 있어요.

더 알아보기

  • API 키를 발급받는 방법은 공식 대시보드의 API 키 페이지를 참고해요.
  • 지원되는 모델 이름과 요금은 모델·요금 문서에서 확인할 수 있어요.