Python SDK
从环境变量读取密钥，创建客户端后发起最小请求。先验证非流式调用，再启用工具调用或图片等高级功能。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["MODB_API_KEY"],
base_url="https://modbapi.com/v1",
timeout=60,
)Node.js SDK
服务端 Node.js 应通过部署平台的 Secret 或环境变量读取密钥。不要在 React、Vue 等浏览器代码中创建带真实密钥的客户端。
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.MODB_API_KEY,
baseURL: "https://modbapi.com/v1",
timeout: 60_000,
});生产环境错误处理
区分鉴权错误、额度错误、限流和上游异常。只对明确可重试的网络错误、429 和部分 5xx 使用有限次数重试，避免重复产生费用。
常见问题
关于OpenAI Python 与 Node.js SDK 接入的常见问题
为什么 SDK 仍然请求官方地址？
确认参数名是 base_url 或 baseURL，并检查是否创建了另一个默认客户端。
前端可以直接使用 API Key 吗？
不可以，浏览器代码会暴露密钥，应通过自己的服务端调用。
请求超时应该设置多久？
根据模型与任务调整，并区分交互请求和后台长任务。