OpenAI 兼容 API

ModelPort 的部分分组提供 OpenAI 兼容接口，可用于 OpenAI SDK、HTTP 请求和支持自定义 Base URL 的客户端。

获取准确参数

进入 API 密钥，打开目标密钥的“使用配置”，选择 OpenAI SDK 或 HTTP API。页面会根据当前分组生成：

• Base URL 和接口路径。
• 认证方式。
• 可使用的模型名称。
• 对应 SDK 或 curl 示例。

不同分组可能使用 Chat Completions、Responses 或其他兼容入口，不要在没有确认分组协议时自行拼接 /v1 路径。

最小验证流程

1. 使用控制台生成的 HTTP 示例。
2. 将示例中的密钥替换为目标密钥，但不要把完整命令保存到共享日志。
3. 发起一个短请求，确认 HTTP 状态和响应内容。
4. 在 用量记录 核对模型、Token 和费用。

SDK 使用建议

• 将密钥放在环境变量或密钥管理服务中。
• 为请求设置合理的连接和读取超时。
• 对 429 和临时上游错误使用有上限的指数退避。
• 不要对认证失败、余额不足等确定性错误无限重试。

截图待补充：OpenAI SDK 与 HTTP API 标签

建议文件：docs/public/images/clients/openai-api-tabs.webp。截取“使用配置”中的 OpenAI SDK 和 HTTP API 标签及脱敏示例。