OpenAI API 中转与兼容接口接入指南

适合哪些 OpenAI API 使用方式

兼容接口适合已经使用 OpenAI Python SDK、Node.js SDK、cURL 或第三方 AI 客户端的项目。应用端不必同时维护多个模型提供商的鉴权和地址配置。

模型是否可用以及对应价格以 Modb API 模型广场的实时列表为准。上线前应在测试密钥下验证模型名称、流式响应和工具调用行为。

• Chat Completions 对话接口
• Responses API 响应接口
• 流式文本输出
• 项目级 API Key 与用量记录

Python SDK 配置示例

安装 OpenAI SDK 后，将 base_url 指向 Modb API。API Key 应通过服务端环境变量读取，不要写入公开代码仓库。

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_MODB_API_KEY",
    base_url="https://modbapi.com/v1",
)

response = client.chat.completions.create(
    model="your-model",
    messages=[{"role": "user", "content": "你好"}],
)

从测试到生产环境

建议为开发、测试和生产环境分别创建密钥，限制每个密钥的模型范围与额度。这样可以在密钥泄露或异常调用时缩小影响范围。

生产环境还应记录请求标识、状态码和耗时，并为 429、5xx 和网络超时配置有限次数的指数退避重试。