> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.
# API 키 생성
> 현재 조직에 새 사용자 API 키를 생성합니다.
## 개요
이 엔드포인트는 현재 관리 토큰에 연결된 조직 안에 새로운 `type=user` API 키를 생성합니다.
## 요청 본문
| 필드 | 타입 | 기본값 / 제한 | 설명 |
| --------------- | -------------- | -------------------------------- | ------------------------------------------------------------------------------- |
| `name` | string | 필수, 기본값 `Default Key`, 길이 `1-50` | 표시 이름이며 서버에서 앞뒤 공백을 제거합니다 |
| `limitAmount` | number \| null | 최소 `0`, 입력 최대 `1000000` | `null` 또는 생략 = 무제한, `0` = 0 한도. 양수는 저장된 상한으로 정규화되며 USD 환산 기준 `100000` 을 넘지 않습니다 |
| `limitCurrency` | enum | default `USD` | USD만 지원됩니다. `CNY`를 보내면 `400 currency_retired`가 반환됩니다. |
| `models` | string\[] | 기본값 `[]` | 선택적 모델 허용 목록 |
| `expiresAt` | string \| null | RFC3339 datetime | `null` 은 만료 없음 의미 |
## 참고 사항
* 전체 API 키 값은 응답에서 한 번만 표시됩니다.
* `models: []` 는 조직 정책 외에 추가 모델 제한이 없음을 의미합니다.
* `limitAmount: 0` 은 유효하지만 사용할 수 있는 한도가 없는 키를 만들며, 이후 업데이트가 필요합니다.
## 예시
```bash cURL theme={null}
curl -X POST "https://api.tokenlab.sh/v1/management/api-keys" \
-H "Authorization: Bearer mt-your-management-token" \
-H "Content-Type: application/json" \
-d '{
"name": "Backend Worker",
"limitAmount": 500,
"models": ["veo3.1", "kling-3.0-video"],
"expiresAt": "2026-12-31T23:59:59Z"
}'
```
## 요청 / 응답
정확한 스키마와 응답 필드는 상단의 대화형 OpenAPI 패널을 참고하세요.
## Response example
```json 201 Created theme={null}
{
"id": "key_abc123def456",
"name": "Backend Worker",
"key": "sk-live-redacted",
"key_prefix": "sk-live...",
"status": "active",
"limit_amount": 500,
"limit_amount_decimal": "500",
"used_amount": 0,
"used_amount_decimal": "0",
"models": [
"veo3.1",
"kling-3.0-video"
],
"expires_at": "2026-12-31T23:59:59.000Z",
"last_used_at": null,
"created_at": "2026-07-08T03:00:00.000Z"
}
```
## Important fields
Full secret API key value. It is returned only once on creation.
API key identifier used in follow-up Management API calls.
Display name for the API key.
Non-secret key prefix for display and support.
One of `active`, `inactive`, or `revoked`.
Spending cap in USD as a JSON number for display. `null` means unlimited.
Exact spending cap in USD as a decimal string. `null` means unlimited.
Accumulated usage in USD as a JSON number for display.
Exact accumulated usage in USD as a decimal string.
Per-key model allowlist. Empty array means no additional key-level model restriction.
ISO timestamp when the key expires, or `null` for no expiry.
ISO timestamp for the most recent use, or `null` when unused.
ISO creation timestamp.