남은 한도 — GET /v1/key

이 키로 오늘 · 이번 달 얼마 더 쓸 수 있는지, 언제까지 쓰는지.

키마다 이번 달 한도 · 오늘 한도 · 기한을 걸 수 있어요(대시보드의 키 목록 「한도 수정」). 이 문은 부르는 키 하나의 그 값을 돌려드려요 — 학생 코드가 부르기 전에 남은 몫을 보여 줄 때 쓰세요. 지갑 전체에 남은 크레딧은 GET /v1/credits 예요. 이 문은 요금이 붙지 않아요.

bash

curl https://oneport.kr/v1/key \
  -H "Authorization: Bearer $ONEPORT_API_KEY"

응답

{
  "object": "key",
  "key_prefix": "sk-so-a1b2c3…",
  "audience": "student",
  "expires_at": "2027-02-28T15:00:00.000Z",
  "usable_until": "2027-02-28",
  "month": { "limit_credits": 5000, "used_credits": 1820, "remaining_credits": 3180, "resets_at": "2026-10-31T15:00:00.000Z" },
  "day": { "limit_credits": 500, "used_credits": 120, "remaining_credits": 380, "resets_at": "2026-10-15T15:00:00.000Z" }
}

응답 필드

파라미터	받는 값	저희가 하는 일
key_prefix	문자열	이 조회에 쓴 키의 앞부분이에요. 키를 여러 개 나눠 쓰실 때 어느 키로 물었는지 확인하는 자리예요.
audience	student · teacher · null	학생 키면 웹 검색 · 웹 페이지 읽기 · 원격 MCP · 영상 만들기가 막혀 있어요. null 은 쓰임새를 나누지 않은 키예요.
expires_at	시각 (ISO) 또는 null	이 시각부터 키가 안 열려요(401). null 이면 기한이 없어요. 보통 고른 날짜의 다음 날 한국 시간 0시예요.
usable_until	날짜 또는 null	마지막으로 쓸 수 있는 한국 날짜예요. 화면에 「…까지」로 보이는 그 날이에요.
month.limit_credits	정수 (크레딧) 또는 null	이 키의 이번 달 한도예요. null 이면 키 한도 없이 지갑 크레딧까지 써요(스페이스 그룹 키면 그룹 몫이 따로 걸려요).
month.used_credits	정수 (크레딧)	이 키로 이번 달(한국 시간) 쓴 크레딧이에요. 끝난 호출만 세요.
month.remaining_credits	정수 (크레딧) 또는 null	이번 달 한도에서 남은 크레딧이에요. 0 아래로는 안 내려가고, 한도가 없으면 null 이에요.
month.resets_at	시각 (ISO)	다음 달 1일 한국 시간 0시예요. 그때 이번 달 사용이 0 부터 다시 세져요.
day.limit_credits	정수 (크레딧) 또는 null	이 키의 오늘 한도예요. null 이면 하루 한도가 없어요.
day.used_credits	정수 (크레딧)	이 키로 오늘(한국 시간) 쓴 크레딧이에요. 끝난 호출만 세요.
day.remaining_credits	정수 (크레딧) 또는 null	오늘 한도에서 남은 크레딧이에요. 0 아래로는 안 내려가고, 한도가 없으면 null 이에요.
day.resets_at	시각 (ISO)	다음 한국 시간 0시예요. 그때 오늘 사용이 0 부터 다시 세져요.

이 문서를 AI 에게 넘기시려면 마크다운 원문을 쓰세요 — 주소 끝에 .md 를 붙이면 나와요.