管理

管理 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/balanceGETWorkspaceの残高を取得
/v1/management/api-keysGETAPIキーの一覧を取得
/v1/management/api-keysPOSTAPIキーを作成
/v1/management/api-keys/{keyId}PATCH名前、上限、モデル、有効期限、またはステータスを変更
/v1/management/api-keys/{keyId}/usageGET個別の利用記録を取得
/v1/management/api-keys/{keyId}/billingGET請求の概要を取得

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意味
400validation_errorフィールドまたはクエリパラメータが無効
400invalid_model_accessmodels 内のモデルがWorkspaceのモデルポリシーで許可されていない
400currency_retiredlimitCurrency が CNY です。USDを使用してください
401invalid_management_tokenトークンが欠落、不正、または取り消されています
403organization_inactiveWorkspaceがアクティブではありません
404not_foundAPIキーがこのWorkspace内に存在しません
409api_key_revoked取り消されたキーは再度有効にできません。新しいキーを作成してください
429report_busy利用状況または請求レポートの処理が多すぎます。Retry-After 秒数経過後に再試行してください

例

curl "https://api.tokenlab.sh/v1/management/balance" \
  -H "Authorization: Bearer mt-your-management-token"

次のステップ

このページの内容