パートナー API エンドポイント

ベース URL: https://panel.model-gate.com/api/v1/partner

すべてのリクエストを次のように認証します Authorization: Bearer mg_partner_...。

APIキー

• POST /keys
• GET /keys
• GET /keys/{id}
• PATCH /keys/{id}
• DELETE /keys/{id}
• POST /keys/{id}/freeze
• POST /keys/{id}/unfreeze
• POST /keys/{id}/rotate
• POST /keys/{id}/reset-usage
• GET /keys/{id}/usage
• GET /keys/{id}/spent-limit

主要な作成および更新フィールド: name、 group_id、 rpm_limit、 concurrency_limit、 spend_limit。数値制限 0 無制限を意味します。 group_id パブリック グループ ID、またはグループがない場合は空の値です。

キーグループ

• GET /groups
• POST /groups
• GET /groups/{id}
• PATCH /groups/{id}
• DELETE /groups/{id}
• POST /groups/{id}/reset-usage
• GET /groups/{id}/usage
• GET /groups/{id}/stats
• GET /groups/{id}/members
• POST /groups/{id}/members
• DELETE /groups/{id}/members/{keyId}

グループの作成フィールドと更新フィールド: name、 description、 status、 rpm_limit、 concurrency_limit、 spend_limit。ステータスは active または frozen。

キーとグループの RPM、同時実行数、および使用量の制限は個別に適用されます。いずれかのレベルがその制限を超えると、リクエストは拒否されます。グループ間でキーを移動しても、履歴統計は書き換えられません。すべてのリクエストでは、リクエスト時にキャプチャされたグループのスナップショットが保持されます。

使用状況をリセットすると、リセット可能な項目がクリアされます usage ウィンドウとアップデート usage_reset_at;それは決して変わりません total_spent。

トランザクションと非同期結果

• GET /transactions
• GET /requests/{request_id}

グループ統計は、完了した期間と生の集計テーブルを使用します。 api_requests 現在の不完全な時間のみ。

識別子の規則: すべて {id} このドキュメントのリソースは public_id。内部数値データベース ID は決して受け入れられず、返されません。ネストされたメンバールートでは、 {keyId} APIキーです public_id。