FAQ 常见问题
平台与账号
SDKMAX 和直接对接 OpenAI/Claude/Gemini 官方有什么区别？ SDKMAX 是聚合层：一个账号、一个 API Key、一套 OpenAI 兼容协议即可调用多家厂商的模型，省去分别注册、分别维护密钥和账单的成本，同时获得渠道自动切换/故障转移等能力。具体见 平台介绍。
注册需要企业资质吗？ 个人开发者可以直接注册使用，企业/团队协作功能请登录后在控制台查看团队设置，或联系平台方开通。
忘记密码怎么办？ 在登录页使用"忘记密码"流程重置；如未开放自助重置，请联系平台方协助处理。
API Key
API Key 和账号密码是一回事吗？ 不是。账号密码用于登录网页控制台；API Key（sk- 开头）用于程序化调用接口，二者相互独立，权限也不同。详见 创建 API Key。
一个 Key 可以设置多个模型/分组限制吗？ 可以，在创建/编辑 Key 时可设置分组与模型限制，用于成本隔离或权限控制。
Key 泄露了怎么办？ 立即在控制台禁用或删除该 Key，创建新 Key 替换，并检查该 Key 关联的用量记录是否有异常调用。
调用相关
为什么用官方 OpenAI SDK 就能调用 SDKMAX？ 因为 SDKMAX 的接口协议与 OpenAI 保持一致，你只需要把 base_url 改成 https://api.sdkmax.com/v1、api_key 换成 SDKMAX 签发的 Key，无需更换 SDK 或重写业务代码。详见 OpenAI 兼容接口。
如何知道当前有哪些模型可用？ 调用 GET /v1/models，或在控制台"模型广场"查看。模型列表会随上游渠道自动同步，请勿在业务代码里硬编码"全部可用模型"的静态清单。
流式输出（stream: true）支持吗？ 支持，协议与 OpenAI SSE 流式响应一致，详见 API 调用方法。
是否支持 Function Calling / Tool Calling？ 支持，具体能力取决于所选模型本身是否支持，请求/响应字段格式与 OpenAI 协议一致。
Batch API 什么时候上线？ 尚未上线，目前请参考 Batch API 页面给出的并发调用替代方案，我们会在正式支持后更新文档。
错误与限流
收到 429 错误怎么办？ 说明触发了额度上限或速率限制，建议使用指数退避策略重试，并检查该 Key 的额度设置。详见 错误码。
收到 model_not_found 怎么办？ 调用 GET /v1/models 确认该模型当前是否可用 —— 上游渠道下线某个模型后，网关会同步移除，建议不要硬编码模型名称直接上线，而是做好模型不可用时的降级/提示逻辑。
图片/视频生成一直是 processing 状态怎么办？ 生成任务本身可能耗时较长（尤其视频），请按建议的间隔轮询；如长时间（例如超过对应模型正常耗时数倍）仍未完成，请联系平台方核实渠道状态。
计费与额度
额度是按 Key 还是按账户计算？ 两者都存在：账户有总额度，单个 Key 也可以单独设置额度上限，以两者中更严格的限制为准，具体以控制台展示为准。
如何查看用量明细？ 登录控制台查看"用量/账单"页面，可按 Key、按模型查看调用次数与消耗。