SRTGen.com LogoSRTGen.com

크레딧 잔액

사용량을 관리하고 작업 실패를 방지하기 위해 현재 사용 가능한 크레딧 잔액을 조회합니다.

GET/api/v1/balance
빠른 구현
curl -X GET https://api.srtgen.com/api/v1/balance \
  -H "x-api-key: <YOUR_API_KEY>"
GEThttps://api.srtgen.com/api/v1/balance

이 엔드포인트는 월간 구독 제공량과 구매한 추가 충전 크레딧을 모두 포함한 총 사용 가능 잔액을 반환합니다.

응답 구조

파라미터유형필수 여부
신원 및 컨텍스트
user객체 (Object)인증된 사용자에 대한 기본 정보.
user.name유형사용자의 표시 이름.
user.email유형등록된 이메일 주소.
크레딧 잔액 상세
credits객체 (Object)상세 크레딧 잔액 내역.
credits.totalBalanceNumber모든 사용 가능한 크레딧의 합계 (제공량 + 충전).
credits.extraCreditsNumber영구 충전 크레딧.
credits.plansArray활성 구독 요금제 목록.
plans[].name유형요금제 표시 이름 (예: '프로 요금제').
plans[].status유형구독 상태 (active, past_due).
plans[].balanceNumber해당 주기에 남은 크레딧.
클라우드 저장소 사용량
storage객체 (Object)클라우드 저장소 사용 통계.
storage.usageNumber바이트 단위의 현재 저장소 사용량.
storage.limitNumber요금제에 따른 바이트 단위의 최대 저장소 한도.
storage.formattedUsage유형읽기 쉬운 형식의 사용량 (예: '2 GB').
storage.formattedLimit유형읽기 쉬운 형식의 한도 (예: '10 GB').
응답 예시: 200 OK
{
  "success": true,
  "user": {
    "name": "Alex Rivera",
    "email": "[email protected]"
  },
  "credits": {
    "totalBalance": 1250,
    "totalMonthlyCredits": 1000,
    "extraCredits": 250,
    "plans": [
      {
        "id": "starter",
        "name": "Starter Plan",
        "status": "active",
        "balance": 1000,
        "total": 1000,
        "resetTime": "2026-04-29T17:48:46.000Z"
      }
    ]
  },
  "storage": {
    "usage": 209715200,
    "limit": 10737418240,
    "formattedUsage": "200 MB",
    "formattedLimit": "10 GB"
  },
  "updatedAt": "2026-03-29T17:48:46.000Z"
}

오류

상태오류 코드설명
401unauthorizedAPI 키가 누락되었거나 유효하지 않습니다.
500server_error예기치 않은 내부 오류가 발생했습니다.
이 페이지가 도움이 되었나요?
크레딧 잔액 | SRTGen.com