# 남은 한도 — GET /v1/key

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

> 원문: https://oneport.kr/docs/reference/key

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

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

**응답**

```json
{
  "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 부터 다시 세져요. |

> **⚠️ 한도는 대략이에요**
>
> 오늘 한도는 그날 쓴 것이 한도에 닿으면 막아요 — 그래서 그날 마지막 한 번과 그 순간 동시에 보낸 호출만큼 한도를 넘길 수 있고(동시에 많이 보낼수록 더), 넘친 몫도 사용으로 세요. 이번 달 한도는 호출을 시작할 때 그 호출이 쓸 수 있는 최대 몫까지 맞대 봐요. 자정을 넘겨 끝난 영상은 다음 날 몫이에요.