管理
APIキーの作成
現在のWorkspace向けにAPIキーを作成します。
概要
管理トークンに関連付けられたWorkspace内に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はWorkspaceの配信ポリシーを継承します。 |
expiresAt | string | null | RFC3339形式の日時 | nullは有効期限なしを意味します |
注意事項
-
金額フィールドはUSDのみです。
CNYの入力は廃止されており、400 currency_retiredが返されます。 -
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-v3.0"],
"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-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
}重要なフィールド
active、inactive、suspended、revokedのいずれか。nullは無制限を意味します。nullは無制限を意味します。auto、verified、official、null。nullはWorkspaceの配信ポリシーを継承します。null。null。認証
ManagementTokenAuth 管理トークン認証。Dashboard > API > Management Tokensで管理トークンを作成または管理します。
場所: header
リクエストボディ
application/json
レスポンス
application/json
application/json
application/json
application/json