管理
管理 API
Workspaceの残高確認、APIキーの管理、利用状況および請求情報の取得
TokenLab Workspaceを管理するために、自身のバックエンドや自動化ツールからManagement APIを使用します。これは管理用トークンを使用するため、プログラムに通常のAPIキーを含める必要はありません。
Dashboard → API → Management Tokens から管理用トークンを作成してください:
Authorization: Bearer mt-your-management-token管理用トークンとAPIキーは役割が異なります。mt-... は /v1/management/* に対してのみ使用してください。モデルAPI(/v1/responses など)には sk-... を使用します。
エンドポイント
| エンドポイント | メソッド | 用途 |
|---|---|---|
/v1/management/balance | GET | Workspaceの残高を取得 |
/v1/management/api-keys | GET | APIキーの一覧を取得 |
/v1/management/api-keys | POST | APIキーを作成 |
/v1/management/api-keys/{keyId} | PATCH | 名前、上限、モデル、有効期限、またはステータスを変更 |
/v1/management/api-keys/{keyId}/usage | GET | 個別の利用記録を取得 |
/v1/management/api-keys/{keyId}/billing | GET | 請求の概要を取得 |
APIキー
- 新しいキーの完全なシークレットは、作成時のレスポンスでのみ表示されます。
models: []は、キーレベルでのモデル制限を設けないことを意味します。limitAmount: nullは無制限を意味します。0を設定すると、そのキーでの支出が制限されます。- 金額はUSD単位です。
CNYを送信すると400 currency_retiredが返されます。 inactive状態のキーは再度有効化できます。キーを完全に無効化するにはrevokedを使用してください。
利用状況と請求
/usage はページネーションされた記録を返し、モデル、モデルメーカー、シーン、日付によるフィルタリングをサポートしています。確定済みの記録には billing_transaction_id が含まれる場合があります。請求とリクエストを照合する必要がある場合は、request_id と共に保存してください。
/billing は、モデル、モデルメーカー、シーン、日付ごとにグループ化された合計値を返します。これにはWorkspaceへのチャージや請求書は含まれません。
2026-07-31 のような日付のみの endDate は、その日の00:00 UTCを意味します。一日全体を含めるには、次の日付を指定するか、2026-07-31T23:59:59Z のようなRFC3339形式の時間を渡してください。
エラー
エラーは標準の error オブジェクトを使用します。ステータスと code によって処理を行ってください。
| ステータス | code | 意味 |
|---|---|---|
| 400 | validation_error | フィールドまたはクエリパラメータが無効 |
| 400 | invalid_model_access | models 内のモデルがWorkspaceのモデルポリシーで許可されていない |
| 400 | currency_retired | limitCurrency が CNY です。USDを使用してください |
| 401 | invalid_management_token | トークンが欠落、不正、または取り消されています |
| 403 | organization_inactive | Workspaceがアクティブではありません |
| 404 | not_found | APIキーがこのWorkspace内に存在しません |
| 409 | api_key_revoked | 取り消されたキーは再度有効にできません。新しいキーを作成してください |
| 429 | report_busy | 利用状況または請求レポートの処理が多すぎます。Retry-After 秒数経過後に再試行してください |
例
curl "https://api.tokenlab.sh/v1/management/balance" \
-H "Authorization: Bearer mt-your-management-token"