GET /credits

계정에 지금까지 들어온 크레딧 총액과 나간 총액을 돌려준다. 값은 원(KRW) 이다.

GET https://openrouter.myip.co.kr/api/v1/credits

인증

Authorization: Bearer <키> 가 필요하다. 추론 키와 관리 키 둘 다 받는다. 크레딧은 키가 아니라 계정에 딸린 것이므로, 같은 계정의 어떤 키로 물어도 같은 답이 나온다.

/api/v1 은 쿠키를 받지 않는다. 로그인한 브라우저에서 잔액을 보여 주는 화면은 세션 쿠키로 /api/dashboard/credits 를 쓴다.

요청 파라미터

없다. 쿼리 파라미터도 본문도 받지 않는다.

요청 예시

curl https://openrouter.myip.co.kr/api/v1/credits \
  -H "Authorization: Bearer $MYIP_API_KEY"

응답

{
  "data": {
    "total_credits": 50000,
    "total_usage": 12480.351200
  }
}

잔액은 어떻게 구하나

잔액 ≈ total_credits - total_usage

값이 언제 바뀌나

• 충전 직후: total_credits 가 결제 승인 시점에 바로 오른다.
• 호출 직후: total_usage 는 응답을 보낸 뒤에 정산되므로 짧은 지연이 있다. 방금 끝난 호출의 비용이 아직 안 보일 수 있다.
• 스트리밍: 스트림이 끝나야([DONE] 또는 연결 종료) 정산된다.

한 호출의 정확한 비용을 즉시 알아야 한다면 이 엔드포인트를 폴링하지 말고, 비스트리밍 응답의 usage.cost 나 응답 헤더 X-MyIP-Cost-KRW, 스트리밍의 usage 청크를 쓴다. 사후 확인은 GET /generation 이 정확하다.

키별 사용액을 보려면

이 엔드포인트는 계정 단위다. 키 하나가 얼마를 썼는지는 GET /key 의 usage·usage_daily·usage_weekly·usage_monthly 를 본다. 한 계정의 모든 키 사용액을 더하면 total_usage 와 맞는다.

오류

{
  "error": {
    "code": 402,
    "message": "크레딧이 부족합니다.",
    "metadata": { "error_type": "insufficient_credits", "balance_krw": "0.000000" }
  }
}

관련 문서

• 크레딧과 결제 — 충전 방법, 1크레딧 = 1원, 최소 결제 금액
• 요금 계산 방식 — 호출 하나의 비용이 정해지는 식
• 사용 한도와 402 — 잔액 소진과 키 정지
• GET /key · /auth/key — 키 단위 사용액