管理
管理 API
Workspaceの残高確認、APIキーの管理、利用状況および請求情報の取得
Management 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のチャージ（トップアップ）や請求書は含まれません。
例
curl "https://api.tokenlab.sh/v1/management/balance" \
-H "Authorization: Bearer mt-your-management-token"