API キーの作成

POST /api/v1/gateway/keys

新しい sk-nex- API キーを作成します。完全なキーはこのレスポンスで一度だけ返されます。直ちに安全に保存してください。

認証：本エンドポイントはコンソールバックエンド API（Base URL https://portal.aiin1.ai、api.portal.aiin1.ai ではありません）に属します。コンソールアカウントでログインして取得した access_token（15 分間有効）が必要で、sk-nex- API トークンは使用できません。ログイン方法は請求照合と使用量自動同期を参照してください。

リクエストボディ

フィールド	型	必須	説明
`name`	string	はい	キー名
`team_id`	string \| null	いいえ	チームに紐付け
`models_allowed`	array<string>	いいえ	利用可能モデルの許可リスト（省略 = 制限なし）
`rpm_limit`	integer	いいえ	毎分リクエスト数の上限
`tpm_limit`	integer	いいえ	毎分トークン数の上限
`is_sandbox`	boolean	いいえ	サンドボックスキーかどうか
`allowed_ips`	array \| null	いいえ	IP 許可リスト（null = 制限なし）
`spending_limit_usd`	number \| string \| null	いいえ	累計消費上限（USD）。null = 無制限
`expires_at`	string \| null	いいえ	有効期限（ISO 8601）

リクエスト例

curl -X POST https://portal.aiin1.ai/api/v1/gateway/keys \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "prod-backend", "rpm_limit": 300, "spending_limit_usd": 500 }'

レスポンス

フィールド	型	必須	説明
`id`	string(uuid)	はい	キー ID
`org_id`	string(uuid)	はい	組織 ID
`team_id`	string \| null	いいえ	所属チーム ID
`name`	string	はい	キー名
`key`	string \| null	いいえ	完全なキー。作成 / ローテーション時に一度だけ返却
`key_prefix`	string	はい	キーのプレフィックス（表示用）
`models_allowed`	array<string>	はい	利用可能モデルの許可リスト（空配列 = 制限なし）
`rpm_limit`	integer	はい	毎分リクエスト数の上限
`tpm_limit`	integer	はい	毎分トークン数の上限
`is_sandbox`	boolean	はい	サンドボックスキーかどうか
`allowed_ips`	array \| null	いいえ	IP 許可リスト（null = 制限なし）
`spending_limit_usd`	string \| null	いいえ	累計消費上限（USD）。null = 無制限
`expires_at`	string \| null	いいえ	有効期限
`rotate_grace_until`	string \| null	いいえ	ローテーション後の旧キーの猶予期限
`status`	string	はい	状態
`created_at`	string(datetime)	はい	作成日時