管理

APIキーの作成

現在のWorkspace向けにAPIキーを作成します。

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

概要

管理トークンに関連付けられたWorkspace内にAPIキーを作成します。完全なシークレットはこのレスポンスで一度だけ表示されます。

リクエストボディ

フィールド型デフォルト値 / 制限説明
namestring任意、デフォルト Default Key、文字数 1-50表示名。サーバー側でトリムされます
limitAmountnumber | string | null0–100000 USDnullは無制限を意味し、0は使用を防止します。10進数文字列は小数点以下最大6桁までサポートします。キー作成時にこのフィールドを省略した場合は無制限を意味します。
limitCurrencyenumデフォルト USDUSDのみ。CNYを送信すると400 currency_retiredが返されます。
modelsstring[]デフォルト []任意のモデル許可リスト
deliveryPolicystring | nullauto, verified, official, nullnullはWorkspaceの配信ポリシーを継承します。
expiresAtstring | nullRFC3339形式の日時nullは有効期限なしを意味します

注意事項

  • 金額フィールドは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
10進数文字列としてのUSD厳密利用上限額。nullは無制限を意味します。
used_amountnumber
表示用のJSON数値としてのUSD累積利用額。
used_amount_decimalstring
10進数文字列としての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