TokenLab
API キーを取得
ドキュメントAPIリファレンス連携

管理

API Key を作成

現在の組織に新しいユーザー API Key を作成します。

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

概要

この endpoint は、現在の管理トークンに紐づく組織内に、新しい type=user API Key を作成します。

リクエストボディ

フィールド型既定値 / 制約説明
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 はワークスペースの配信ポリシーを継承します。
expiresAtstring | nullRFC3339 datetimenull は期限なしを意味します

補足

  • 金額フィールドは USD のみをサポートします。CNY 入力は廃止されており、400 currency_retired が返されます。

  • 完全な API Key 値はレスポンスで一度だけ返されます。

  • models: [] は、組織ポリシー以外の追加制限がないことを意味します。

  • limitAmount: 0 は有効だが利用可能額 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-3.0-video"],
    "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-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

APIキー一覧

前へ

API Key を更新

次へ