TokenLab

관리

API 키 생성

현재 Workspace에 대한 API 키를 생성합니다.

POSThttps://api.tokenlab.sh/v1/management/api-keys

개요

관리 토큰과 연결된 Workspace에서 API 키를 생성합니다. 전체 시크릿은 이 응답에서 한 번만 표시됩니다.

요청 본문

필드타입기본값 / 제한설명
namestring선택 사항, 기본값 Default Key, 길이 1-50표시 이름이며 서버 측에서 공백이 제거(trim)됩니다
limitAmountnumber | string | null0–100000 USDnull은 무제한을 의미하며, 0은 지출을 차단합니다. 소수점 문자열은 소수점 이하 최대 6자리까지 지원합니다. 키 생성 시 이 필드를 생략하면 무제한으로 설정됩니다.
limitCurrencyenum기본값 USDUSD 전용입니다. CNY를 전송하면 400 currency_retired가 반환됩니다.
modelsstring[]기본값 []선택적 모델 허용 목록
deliveryPolicystring | nullauto, verified, official, nullnull은 Workspace 전송 정책을 상속합니다.
expiresAtstring | nullRFC3339 datetimenull은 만료 없음을 의미합니다

참고 사항

  • 통화 관련 필드는 USD 전용입니다. CNY 입력은 지원 중단되었으며 400 currency_retired를 반환합니다.

  • models: []는 키 수준의 모델 제한을 추가하지 않습니다.

  • limitAmount: 0은 유효하지만 업데이트되기 전까지 할당량을 사용할 수 없는 키를 생성합니다.

예제

요청

cURL
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-v3.0"],
    "expiresAt": "2026-12-31T23:59:59Z"
  }'

요청 / 응답

이 페이지에서는 OpenAPI 스키마 및 복사 가능한 요청 예제를 제공합니다. 터미널 또는 클라이언트에서 Management Token을 사용하여 관리 요청을 전송하세요. 이 페이지에서는 직접 전송할 수 없습니다.

응답 예제

응답

201 Created
{
  "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-v3.0"
  ],
  "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
소수점 문자열 형식의 정확한 USD 지출 한도입니다. null은 무제한을 의미합니다.
used_amountnumber
표시용 JSON 숫자 형식의 USD 누적 사용량입니다.
used_amount_decimalstring
소수점 문자열 형식의 정확한 USD 누적 사용량입니다.
modelsstring[]
키별 모델 허용 목록입니다. 빈 배열은 추가적인 키 수준 모델 제한이 없음을 의미합니다.
delivery_policystring | null
auto, verified, official, null. null은 Workspace 전송 정책을 상속합니다.
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