관리
API 키 생성
현재 조직에 새 사용자 API 키를 생성합니다.
POSThttps://api.tokenlab.sh/v1/management/api-keys
개요
이 엔드포인트는 현재 관리 토큰에 연결된 조직 안에 새로운 type=user API 키를 생성합니다.
요청 본문
| 필드 | 타입 | 기본값 / 제한 | 설명 |
|---|---|---|---|
name | string | 선택 사항, 기본값 Default Key, 길이 1-50 | 표시 이름이며 서버에서 앞뒤 공백을 제거합니다 |
limitAmount | number | string | null | 0–100000 USD | null은 무제한, 0은 지출 불가입니다. 10진 문자열은 소수점 아래 6자리까지 지원합니다. 키 생성 시 생략하면 무제한입니다. |
limitCurrency | enum | 기본값 USD | USD만 지원됩니다. CNY를 보내면 400 currency_retired가 반환됩니다. |
models | string[] | 기본값 [] | 선택적 모델 허용 목록 |
deliveryPolicy | string | null | auto, verified, official, null | null은 워크스페이스의 전달 정책을 상속합니다. |
expiresAt | string | null | RFC3339 datetime | null 은 만료 없음 의미 |
참고 사항
-
금액 필드는 USD만 지원합니다.
CNY입력은 지원이 종료되었으며400 currency_retired가 반환됩니다. -
전체 API 키 값은 응답에서 한 번만 표시됩니다.
-
models: []는 조직 정책 외에 추가 모델 제한이 없음을 의미합니다. -
limitAmount: 0은 유효하지만 사용할 수 있는 한도가 없는 키를 만들며, 이후 업데이트가 필요합니다.
요청
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 스키마와 복사 가능한 요청 예제를 제공합니다. 관리 요청은 Management Token을 사용해 터미널이나 클라이언트에서 전송하세요. 이 페이지에서는 직접 전송할 수 없습니다.
응답
{
"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",
"delivery_policy": null
}주요 필드
keystring
전체 API 키 비밀값입니다. 생성 시 한 번만 반환됩니다.
idstring
후속 Management API 호출에 사용하는 API 키 식별자입니다.
namestring
API 키의 표시 이름입니다.
key_prefixstring
표시 및 지원에 사용하는 비밀이 아닌 키 접두사입니다.
statusstring
active, inactive, suspended, revoked 중 하나입니다.limit_amountnumber | null
표시용 JSON 숫자로 반환되는 USD 지출 한도입니다.
null은 무제한을 의미합니다.limit_amount_decimalstring | null
10진 문자열로 반환되는 정확한 USD 지출 한도입니다.
null은 무제한을 의미합니다.used_amountnumber
표시용 JSON 숫자로 반환되는 USD 누적 사용 금액입니다.
used_amount_decimalstring
10진 문자열로 반환되는 정확한 USD 누적 사용 금액입니다.
modelsstring[]
키별 모델 허용 목록입니다. 빈 배열은 추가적인 키 수준 모델 제한이 없음을 의미합니다.
delivery_policystring | null
auto, verified, official, null. null은 워크스페이스의 전달 정책을 상속합니다.expires_atstring | null
키 만료 시각의 ISO 타임스탬프이며, 만료되지 않으면
null입니다.last_used_atstring | null
가장 최근 사용 시각의 ISO 타임스탬프이며, 사용한 적이 없으면
null입니다.created_atstring
생성 시각의 ISO 타임스탬프입니다.
인증
ManagementTokenAuth AuthorizationBearer <token>
관리 토큰 인증입니다. Dashboard > API > Management Tokens에서 관리 토큰을 생성하거나 관리하십시오.
위치: header
요청 본문
application/json
응답
application/json
application/json
application/json
application/json