合作伙伴 API 端点

基本网址： 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 仅适用于当前不完整的小时。

标识符约定：every {id} 本文档中是资源 public_id。内部数字数据库 ID 永远不会被接受或返回。在嵌套成员路由中， {keyId} 是 API 密钥 public_id。