メインコンテンツまでスキップ

個人管理 API

個人管理 API は、スクリプト、社内ダッシュボード、自動化ツール向けです。初版では残高照会、利用可能なグループ、API キーの作成・一覧・更新・削除、キー別 Usage の明細・集計・日次推移を提供します。

管理キーの作成​

MuskAI にログインし、API キー ページの「個人管理 API」カードから作成します。

キーは sk-mgmt- で始まり、完全な値は作成時に一度だけ表示されます。サーバーにはハッシュのみ保存されます。

:::warning 高権限の認証情報 このキーは残高の参照とアカウント内すべての API キーの管理ができます。Claude Code、Codex、Cherry Studio などのモデルクライアントには設定しないでください。通常の推論 API キーでは管理 API を呼び出せません。 :::

ベース URL と認証​

BASE_URL="https://muskapi.cc/api/v1/management"
MANAGEMENT_KEY="sk-mgmt-..."
Authorization: Bearer sk-mgmt-...
Content-Type: application/json

成功レスポンスは { "code": 0, "message": "success", "data": ... } 形式です。

エンドポイント​

メソッドパス用途
GET/balance残高照会
GET/groups/availableバインド可能なグループ一覧
GET/groups/ratesユーザー別グループ倍率
GET/api-keysAPI キー一覧
POST/api-keysAPI キー作成
GET/api-keys/{id}1 件の参照
PUT/api-keys/{id}1 件の更新
DELETE/api-keys/{id}1 件の削除
GET/api-keys/{id}/usageリクエスト単位の Usage
GET/api-keys/{id}/usage/statsUsage 集計
GET/api-keys/{id}/usage/daily日次 Usage

使用例​

残高照会：

curl "$BASE_URL/balance" -H "Authorization: Bearer $MANAGEMENT_KEY"

API キー一覧：

curl "$BASE_URL/api-keys?page=1&page_size=20&status=active" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

作成：

curl -X POST "$BASE_URL/api-keys" \
  -H "Authorization: Bearer $MANAGEMENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"production-bot","group_id":12,"quota":20,"rate_limit_1d":5,"expires_in_days":90}'

作成時は name、group_id、group_bindings、cross_group_retry_enabled、custom_key、count、quota、各種 rate_limit_*、expires_in_days、IP リストなどを指定できます。

更新：

curl -X PUT "$BASE_URL/api-keys/123" \
  -H "Authorization: Bearer $MANAGEMENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"production-bot-v2","status":"active","quota":50,"expires_at":"2026-12-31T23:59:59Z"}'

省略したフィールドは変更されません。reset_quota: true と reset_rate_limit_usage: true も利用できます。バインドを維持したい場合は空の group_bindings を送信しないでください。

キー別 Usage：

curl "$BASE_URL/api-keys/123/usage?page=1&page_size=50&start_date=2026-08-01&end_date=2026-08-11&timezone=Asia%2FTokyo" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

curl "$BASE_URL/api-keys/123/usage/stats?period=month" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

curl "$BASE_URL/api-keys/123/usage/daily?days=30&timezone=Asia%2FTokyo" \
  -H "Authorization: Bearer $MANAGEMENT_KEY"

すべての {id} は管理キーに対応するユーザーの所有物か検証されます。

ローテーションと失効​

API キー → 個人管理 API から再生成または失効できます。再生成すると旧キーは即時無効になります。シークレットマネージャーまたは環境変数に保存し、Git へコミットしないでください。