Skip to Content
ガイドアカウントと管理マネジメントトークン

マネジメントトークン

マネジメントトークン：ダッシュボードと同じ管理操作をAPIから自動化するための認証情報です。 ダッシュボードのサイドバー「管理」から発行します。 発行には、組織のロール管理とメンバー管理を行う権限が必要です。

発行する

トークンには名前と有効期限を設定します。

  • 名前：1〜100文字で指定し、既定では マネジメントトークン_2026-08-21 のように発行日が入った名前になります
  • 有効期限：1日、7日、30日、90日、180日、365日から選ぶか、カスタムで日付を指定します

有効期限には無期限も選べます。 既定は30日です。

トークンの平文は発行直後に一度だけ表示されます。 期限を過ぎたトークンは認証に使えません。 無期限を選んだ場合も、不要になったトークンは同じ画面から無効化してください。

管理APIを呼び出す

管理APIのベースパスは /console/v1 です。 組織IDとトークンを環境変数へ設定します。

Shell
export AI_GATEWAY_BASE_URL="https://ai-gateway.lolipop.jp"
export AI_GATEWAY_ACCOUNT_ID="<組織ID>"
export AI_GATEWAY_MANAGEMENT_TOKEN="<発行したマネジメントトークン>"

次の例は、トークンが属する組織の情報を取得します。

Shell
curl "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"
JSON
{
  "accountId": "00000000-0000-4000-8000-000000000000",
  "displayName": "Example",
  "kind": "organization",
  "status": "active"
}

プロジェクトの一覧は次のパスで取得します。

Shell
curl "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"

トークンは発行した組織にだけ使用できます。 別の組織IDを指定しても、その組織の情報は取得できません。

エンドポイント一覧

マネジメントトークンで呼び出せるエンドポイントの一覧です。 パスはすべて /console/v1 からの相対です。 :accountId は組織ID、:projectId はプロジェクトIDに置き換えます。

組織

GET /accounts/:accountId — 組織情報を取得する

Shell
curl "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"
200 OK
{
  "accountId": "00000000-0000-4000-8000-000000000000",
  "displayName": "Example",
  "kind": "organization",
  "status": "active"
}

PATCH /accounts/:accountId — 組織情報を更新する

displayName、rpmLimit、tpmLimit のうち1つ以上を指定します。

Shell
curl -X PATCH "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "displayName": "New Name" }'
200 OK
{
  "account": {
    "accountId": "00000000-0000-4000-8000-000000000000",
    "displayName": "New Name",
    "kind": "organization",
    "status": "active",
    "billingType": "prepaid",
    "rpmLimit": null,
    "tpmLimit": null
  }
}

メンバーと招待

GET /accounts/:accountId/members — メンバー一覧を取得する

Shell
curl "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/members" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"
200 OK
{
  "account": { "accountId": "...", "displayName": "Example", "kind": "organization", "status": "active" },
  "viewer": { "humanPrincipalId": "...", "canManageRoles": true, "canRemoveMember": true, "manageableProjects": [] },
  "accountRoles": [{ "roleId": "...", "effectiveRole": "owner", "actions": [] }],
  "members": [{
    "humanPrincipalId": "...",
    "displayName": "Alice",
    "email": "alice@example.com",
    "roleId": "...",
    "effectiveRole": "owner",
    "status": "active",
    "projects": [{ "projectId": "...", "displayName": "Production", "effectiveRole": "admin", "roleId": "..." }]
  }]
}

PATCH /accounts/:accountId/members/:humanPrincipalId — メンバーのロールを変更する

Shell
curl -X PATCH "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/members/$MEMBER_ID" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "roleId": "<ロールID>" }'

レスポンスは 204 No Content です。

DELETE /accounts/:accountId/members/:humanPrincipalId — メンバーを削除する

Shell
curl -X DELETE "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/members/$MEMBER_ID" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"

レスポンスは 204 No Content です。

GET /accounts/:accountId/invitations — 招待一覧を取得する

Shell
curl "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/invitations" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"
200 OK
{
  "viewer": { "canInvite": true, "canCancel": true },
  "invitations": [{
    "invitationId": "...",
    "role": { "roleId": "...", "effectiveRole": "member" },
    "invitedEmail": null,
    "createdAt": "2026-09-01T00:00:00.000Z",
    "expiresAt": "2026-09-08T00:00:00.000Z"
  }]
}

POST /accounts/:accountId/invitations — メンバーを招待する

roleId は必須です。email を指定するとメール招待になります。

Shell
curl -X POST "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/invitations" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "roleId": "<ロールID>", "email": "bob@example.com" }'
201 Created
{
  "invitation": {
    "invitationId": "...",
    "expiresAt": "2026-09-14T00:00:00.000Z",
    "invitationUrl": "https://ai-gateway.lolipop.jp/invite#token=..."
  }
}

DELETE /accounts/:accountId/invitations/:invitationId — 招待を削除する

Shell
curl -X DELETE "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/invitations/$INVITATION_ID" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"

レスポンスは 204 No Content です。

プロジェクト

GET /accounts/:accountId/projects — プロジェクト一覧を取得する

Shell
curl "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"
200 OK
{
  "account": { "accountId": "...", "displayName": "Example", "kind": "organization", "status": "active", "billingType": "prepaid" },
  "viewer": { "humanPrincipalId": "...", "effectiveRole": "owner", "capabilities": { "createProject": true, "disableProject": true, "enableProject": true, "deleteProject": true, "inviteMember": true, "removeMember": true, "manageRoles": true, "manageAccountSettings": true, "manageBilling": true } },
  "projectRoles": [{ "roleId": "...", "effectiveRole": "admin", "actions": [] }],
  "projects": [{
    "projectId": "...",
    "displayName": "Production",
    "status": "active",
    "teamExternalRef": null,
    "state": "ready",
    "effectiveRole": "owner",
    "metadata": { "memberCount": 3, "keyCount": 5 }
  }]
}

POST /accounts/:accountId/projects — プロジェクトを作成する

Shell
curl -X POST "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "displayName": "Staging", "idempotencyKey": "550e8400-e29b-41d4-a716-446655440000" }'
201 Created
{
  "project": {
    "projectId": "...",
    "displayName": "Staging",
    "status": "active",
    "state": "preparing"
  }
}

idempotencyKey に同じ UUID を指定して再送すると、重複作成せずに既存プロジェクトを 200 OK で返します。

PATCH /accounts/:accountId/projects/:projectId — プロジェクトを更新する

Shell
curl -X PATCH "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "displayName": "Production v2" }'
200 OK
{
  "project": { "projectId": "...", "displayName": "Production v2", "status": "active", "teamExternalRef": null, "state": "ready" }
}

POST /accounts/:accountId/projects/:projectId/disable — プロジェクトを無効にする

Shell
curl -X POST "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID/disable" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"
200 OK
{
  "project": { "projectId": "...", "displayName": "Production", "status": "disable", "teamExternalRef": null, "state": "disabled" }
}

POST /accounts/:accountId/projects/:projectId/enable — プロジェクトを有効にする

Shell
curl -X POST "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID/enable" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"
200 OK
{
  "project": { "projectId": "...", "displayName": "Production", "status": "active", "teamExternalRef": null, "state": "ready" }
}

DELETE /accounts/:accountId/projects/:projectId — プロジェクトを削除する

Shell
curl -X DELETE "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"

レスポンスは 204 No Content です。

GET /accounts/:accountId/projects/:projectId/members — プロジェクトメンバー一覧を取得する

Shell
curl "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID/members" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"
200 OK
{
  "project": { "projectId": "...", "displayName": "Production", "status": "active", "teamExternalRef": null, "state": "ready" },
  "viewer": { "humanPrincipalId": "...", "effectiveRole": "owner", "canManageMembers": true },
  "projectRoles": [{ "roleId": "...", "effectiveRole": "admin", "actions": [] }],
  "members": [{
    "humanPrincipalId": "...",
    "displayName": "Alice",
    "email": "alice@example.com",
    "effectiveRole": "admin",
    "roleId": "..."
  }]
}

PUT /accounts/:accountId/projects/:projectId/members/:humanPrincipalId — プロジェクトメンバーを追加・更新する

Shell
curl -X PUT "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID/members/$MEMBER_ID" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "roleId": "<プロジェクトロールID>" }'
200 OK
{
  "membership": {
    "humanPrincipalId": "...",
    "displayName": "Bob",
    "effectiveRole": "admin",
    "roleId": "..."
  }
}

DELETE /accounts/:accountId/projects/:projectId/members/:humanPrincipalId — プロジェクトメンバーを削除する

Shell
curl -X DELETE "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID/members/$MEMBER_ID" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"

レスポンスは 204 No Content です。

GET /accounts/:accountId/projects/:projectId/settings — プロジェクト設定を取得する

Shell
curl "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID/settings" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"
200 OK
{
  "maxBudgetMicroJpy": 10000000000,
  "budgetDuration": "1mo",
  "rpmLimit": null,
  "tpmLimit": null,
  "spendMicroJpy": 6587500000,
  "nextBudgetResetAt": "2026-10-01T00:00:00.000Z",
  "viewer": { "canManage": true }
}

maxBudgetMicroJpy と spendMicroJpy の単位はマイクロ円（1円 = 1,000,000）です。

PUT /accounts/:accountId/projects/:projectId/settings — プロジェクト設定を更新する

4フィールドすべてを指定します。 maxBudgetMicroJpy と budgetDuration は両方 null か両方非 null にします。

Shell
curl -X PUT "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID/settings" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "maxBudgetMicroJpy": 20000000000, "budgetDuration": "1mo", "rpmLimit": 60, "tpmLimit": null }'
200 OK
{
  "maxBudgetMicroJpy": 20000000000,
  "budgetDuration": "1mo",
  "rpmLimit": 60,
  "tpmLimit": null,
  "spendMicroJpy": 6587500000,
  "nextBudgetResetAt": "2026-10-01T00:00:00.000Z",
  "viewer": { "canManage": true }
}

ルール

GET /accounts/:accountId/projects/:projectId/rules — ルール一覧を取得する

Shell
curl "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID/rules" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"
200 OK
{
  "viewer": { "humanPrincipalId": "...", "canManage": true },
  "rules": [{
    "ruleId": "...",
    "name": "Standard",
    "settings": {
      "maxBudgetMicroJpy": 5000000000,
      "budgetDuration": "month",
      "rpmLimit": null,
      "tpmLimit": null,
      "models": [],
      "autoCandidates": [],
      "routingStrategy": null,
      "fallbackModels": [],
      "forceAuto": false,
      "guardrails": []
    },
    "createdAt": "2026-08-01T00:00:00.000Z",
    "appliedKeyCount": 3
  }]
}

POST /accounts/:accountId/projects/:projectId/rules — ルールを作成する

name と settings は両方必須です。settings 内の各フィールドは任意です。

Shell
curl -X POST "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID/rules" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Budget Limited",
    "settings": {
      "maxBudgetMicroJpy": 1000000000,
      "budgetDuration": "month",
      "rpmLimit": 30
    }
  }'
201 Created
{
  "rule": {
    "ruleId": "...",
    "name": "Budget Limited",
    "settings": { "maxBudgetMicroJpy": 1000000000, "budgetDuration": "month", "rpmLimit": 30 },
    "createdAt": "2026-09-07T00:00:00.000Z",
    "appliedKeyCount": 0
  }
}

PATCH /accounts/:accountId/projects/:projectId/rules/:ruleId — ルールを更新する

name と settings のいずれかまたは両方を指定します。 settings を指定した場合、既存の settings は全体が置換されます（マージではありません）。維持したい設定は再送してください。

Shell
curl -X PATCH "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID/rules/$RULE_ID" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "settings": { "maxBudgetMicroJpy": 2000000000, "budgetDuration": "month", "rpmLimit": 30 } }'
200 OK
{
  "rule": { "ruleId": "...", "name": "Budget Limited", "settings": { "maxBudgetMicroJpy": 2000000000, "budgetDuration": "month", "rpmLimit": 30 }, "createdAt": "...", "appliedKeyCount": 3 }
}

DELETE /accounts/:accountId/projects/:projectId/rules/:ruleId — ルールを削除する

Shell
curl -X DELETE "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID/rules/$RULE_ID" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"

レスポンスは 204 No Content です。 適用中のAPIキーがある場合はエラーが返ります。

APIキー

GET /accounts/:accountId/projects/:projectId/keys — APIキー一覧を取得する

Shell
curl "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID/keys" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"
200 OK
{
  "viewer": { "humanPrincipalId": "..." },
  "projects": [{ "projectId": "...", "displayName": "Production", "status": "active", "state": "ready", "capabilities": { "issueKey": true, "revokeKey": true }, "compatibleRuleIds": [] }],
  "keys": [{
    "keyId": "...",
    "keyAlias": "production-key",
    "projectId": "...",
    "ruleId": null,
    "expiresAt": "2026-10-07T00:00:00.000Z",
    "blocked": false,
    "spendMicroJpy": 1906500000,
    "maxBudgetMicroJpy": null,
    "budgetDuration": null,
    "rpmLimit": null,
    "tpmLimit": null,
    "models": [],
    "autoCandidates": [],
    "routingStrategy": null,
    "fallbackModels": [],
    "forceAuto": false,
    "guardrails": []
  }]
}

POST /accounts/:accountId/projects/:projectId/keys — APIキーを発行する

keyAlias、expiresInDays、operationId、attemptId、recovery は必須です。 operationId と attemptId は UUID を生成して指定します。

Shell
curl -X POST "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID/keys" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "keyAlias": "ci-deploy",
    "expiresInDays": 90,
    "operationId": "550e8400-e29b-41d4-a716-446655440000",
    "attemptId": "550e8400-e29b-41d4-a716-446655440001",
    "recovery": false,
    "ruleId": null,
    "maxBudgetMicroJpy": 5000000000
  }'
201 Created
{
  "operationId": "550e8400-e29b-41d4-a716-446655440000",
  "attemptId": "550e8400-e29b-41d4-a716-446655440001",
  "key": {
    "keyId": "...",
    "keyAlias": "ci-deploy",
    "key": "sk-...",
    "expiresAt": "2026-12-06T00:00:00.000Z",
    "maxBudgetMicroJpy": 5000000000,
    "budgetDuration": null,
    "budgetPeriodStartedAt": null,
    "nextBudgetResetAt": null
  }
}

key フィールドの平文は発行時に一度だけ返ります。

PATCH /accounts/:accountId/projects/:projectId/keys/:keyId — APIキーの設定を変更する

変更したいフィールドだけを指定します。

Shell
curl -X PATCH "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID/keys/$KEY_ID" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "maxBudgetMicroJpy": 10000000000 }'
200 OK
{
  "key": { "keyId": "...", "keyAlias": "ci-deploy", "maxBudgetMicroJpy": 10000000000, "budgetDuration": null, "budgetPeriodStartedAt": null, "nextBudgetResetAt": null }
}

POST /accounts/:accountId/projects/:projectId/keys/:keyId/rotate — APIキーを再生成する

Shell
curl -X POST "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID/keys/$KEY_ID/rotate" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "operationId": "550e8400-e29b-41d4-a716-446655440002",
    "attemptId": "550e8400-e29b-41d4-a716-446655440003",
    "recovery": false
  }'
200 OK
{
  "operationId": "550e8400-e29b-41d4-a716-446655440002",
  "attemptId": "550e8400-e29b-41d4-a716-446655440003",
  "key": { "keyId": "...", "key": "sk-..." }
}

key フィールドに新しい平文が入ります。以前のキーは使えなくなります。

POST /accounts/:accountId/projects/:projectId/keys/provisioning/:operationId/confirm — プロビジョニング操作を確認する

Shell
curl -X POST "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID/keys/provisioning/$OPERATION_ID/confirm" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "attemptId": "550e8400-e29b-41d4-a716-446655440001" }'
200 OK
{
  "key": { "keyId": "...", "keyAlias": "ci-deploy" }
}

POST /accounts/:accountId/projects/:projectId/keys/:keyId/block — APIキーを無効にする

Shell
curl -X POST "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID/keys/$KEY_ID/block" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"
200 OK
{
  "key": { "keyId": "...", "keyAlias": "ci-deploy", "blocked": true }
}

POST /accounts/:accountId/projects/:projectId/keys/:keyId/unblock — APIキーを有効にする

Shell
curl -X POST "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID/keys/$KEY_ID/unblock" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"
200 OK
{
  "key": { "keyId": "...", "keyAlias": "ci-deploy", "blocked": false }
}

DELETE /accounts/:accountId/projects/:projectId/keys/:keyId — APIキーを削除する

Shell
curl -X DELETE "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/projects/$PROJECT_ID/keys/$KEY_ID" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"

レスポンスは 204 No Content です。

使用状況

GET /accounts/:accountId/activity — 日別の使用状況を取得する

start から end までの使用状況を、日付・プロジェクト・モデルごとの行で返します。 日付は日本時間の YYYY-MM-DD で指定し、end の日も含みます。 指定できる期間は最長366日です。

Shell
curl "$AI_GATEWAY_BASE_URL/console/v1/accounts/$AI_GATEWAY_ACCOUNT_ID/activity?start=2026-09-01&end=2026-09-30" \
  -H "Authorization: Bearer $AI_GATEWAY_MANAGEMENT_TOKEN"
200 OK
{
  "data": [{
    "date": "2026-09-01",
    "projectId": "...",
    "model": "anthropic/claude-sonnet-5-5",
    "totals": {
      "requestCount": "12",
      "inputTokens": "3400",
      "outputTokens": "1200",
      "byokUsage": { "totalCostUsd": "0", "jpyCost": "0" },
      "charge": { "totalCostUsd": "0.0282", "jpyCost": "4.23" }
    }
  }]
}

totals の項目は使用状況画面と同じです（例では一部を省略しています）。 プロジェクトに紐付かない利用は projectId が null の行になります。 行数が上限を超える期間を指定すると 422 を返すため、期間を分けて取得してください。

保管と更新

トークンはソースコードへ直接書かず、シークレット管理機能や環境変数へ保存してください。 有効期限より前に新しいトークンを発行し、自動化処理の値を差し替えて疎通を確認してから、古いトークンを無効化します。

APIキーとの違い

マネジメントトークンは推論APIには使えません。 指定すると 401 / invalid_api_key が返ります。 /v1/chat/completions などの呼び出しには、プロジェクトごとのAPIキー画面で発行したAPIキーを使ってください。

APIキープロジェクト