크레딧과 사용량

하는 일엔드포인트
남은 크레딧GET /v1/credits
날짜별 크레딧 사용 내역GET /v1/usage

두 엔드포인트는 크레딧이 들지 않아요.

남은 크레딧

GET /v1/credits
curl https://api.devdive.ai/v1/credits \
  -H "Authorization: Bearer $DEVDIVE_API_KEY"
{ "object": "credits", "balance": 99093.787 }

balance는 키가 가리키는 계정에 지금 남은 크레딧이에요. 데브다이브 웹 설정 › 크레딧에 보이는 값과 같아요.

날짜별 사용 내역

GET /v1/usage
쿼리기본값설명
limit30받을 날짜 수(1~200). 최근 날짜부터 와요
curl "https://api.devdive.ai/v1/usage?limit=7" \
  -H "Authorization: Bearer $DEVDIVE_API_KEY"
{
  "object": "list",
  "data": [
    { "date": "2026-11-03", "change": 9367.76, "remaining": 100156.659 },
    { "date": "2026-11-02", "change": 9751.494, "remaining": 109524.419 }
  ],
  "total": 75
}
필드설명
date날짜
change그날 바뀐 크레딧의 양
remaining그날을 마친 뒤 남은 크레딧
total기록이 있는 날짜 수
  • 사용 내역은 하루 단위로 모여요. 호출 하나하나의 금액은 각 응답의 credits_used에서 보세요.
  • 웹·MCP·API로 쓴 크레딧이 모두 합쳐져요.
  • 기능·모델별 사용 금액과 호출 수는 데브다이브 웹 설정 › 모델 사용량에서 볼 수 있어요.

크레딧이 모자랄 때

크레딧이 모자라면 크레딧이 드는 호출이 402 insufficient_credits로 거절돼요. 데브다이브 웹에서 크레딧을 충전한 뒤 다시 보내세요.

비싼 작업 전에 잔액을 확인하세요

영상처럼 크레딧이 많이 드는 작업을 자동으로 돌린다면, 보내기 전에 GET /v1/credits로 잔액을 확인하고 내 서비스에서 상한을 정해 두세요.