Partner API常见问题解答

帐户 API 密钥和模型 API 密钥有什么区别？

账户级API密钥（mg_partner_...）通过管理模型 API 密钥 https://p-api.model-gate.com/api/v1/partner/* 并通过检索异步结果 https://p-api.model-gate.com/api/v1/requests/{request_public_id}。

模型 API 密钥（mg_live_...）通过验证推理请求 https://api.model-gate.com。

切勿将帐户级 Partner API 密钥发送到推理端点或在客户端应用程序中公开它。

哪个计数器强制执行 spend_limit？

可复位的 usage 计数器强制执行限制。 POST /api/v1/partner/keys/{key_public_id}/reset-usage 清除密钥计数器。 total_spent 是终生会计并且永不重置。

每个模型 API 密钥是否都有单独的帐户余额？

不会。所有模型 API 密钥均从拥有的 Model Gate 帐户余额中支出。每个密钥和组的限制限制使用，而不将帐户余额拆分为子余额。

模型 API 密钥轮换时会发生什么？

旧秘密立即失效。轮换响应包含一次新的明文秘密。安全地保存它，因为模型门不会再次显示完整的秘密。

回调是如何配置的？

配置 callback_url 并旋转 callback_secret 在模型门配置文件中。当回调 URL 存在时，发送异步完成结果。可选的低密钥限制、关键组限制和低账户余额事件可单独启用；它们的阈值在配置文件通知中配置。

回调传递是持久的并且独立于推理处理。每一次活动都承载着稳定 event_id 在重试中保持不变，并且必须用于消费者重复数据删除。任何 HTTP 2xx 响应成功。投递总共最多尝试6次，5秒、30秒、2分钟、10分钟、1小时后重试；每次尝试都有 15 秒的总超时时间。重试传输错误、超时和非 2xx 响应，并在第六次失败尝试后标记该事件 failed 不再自动重试。看 回调 对于事件目录、精确的十进制有效负载、签名、目的地安全性和传递详细信息。

异步结果多久可以检索到？

异步结果在 24 小时内保持可用 GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}。过期后，存储的请求和响应将被删除，端点返回 404。

伙伴突变是否支持安全重试？

是的。每Partner API POST, PATCH， 和 DELETE 需要 Idempotency-Key。超时后重试相同key的相同逻辑操作； 7 天 Model Gate 返回原始结果，不再执行变异。对不同的请求返回重用密钥 409。

详细的请求历史记录可以使用多长时间？

详细的合作伙伴请求历史记录如下 API_REQUESTS_HOT_RETENTION_DAYS （默认 7 天）并报告响应元数据中的窗口。使用光标分页的账户余额交易进行长期财务对账。