准备三项配置
| 配置 | 从哪里获取 | 建议 |
|---|---|---|
| API Key | 控制台 API 密钥或令牌页 | 测试和生产分开，不使用登录密码或会话 Cookie |
| Base URL | 本站地址说明 | OpenAI 兼容 SDK 通常以 /v1 结尾 |
| 模型 ID | 控制台模型列表或模型列表接口 | 原样复制，不在示例中猜测型号 |
推荐验证顺序
- 创建密钥，设置合理额度，确认账户、模型和分组可用。
- 阅读API 鉴权，将密钥保存为服务端环境变量。
- 使用模型查询验证地址和认证。拿到模型列表后，仍需验证具体模型的生成能力。
- 按第一条 HTTP 请求发送普通文本。Python 或 Node.js 用户可直接进入对应 SDK 文档。
- 基础请求成功后再测试流式输出、工具调用或其他所需能力。
- 上线前设置超时、限流、预算和脱敏日志，完成上线检查。
不要用一套格式调用所有模型
Chat Completions、Responses、Anthropic Messages 和 Gemini 原生协议的路径、请求体及返回结构不同。先确认模型支持哪种协议，再选择 SDK；模型名字相近不代表能力相同。详见兼容性说明。
成功标准
除了 HTTP 成功状态，还应检查返回正文、完成原因和业务需要的字段。保存状态码、请求 ID（若返回）、耗时、模型和用量，不记录完整密钥或用户敏感正文。
下一步：Python SDK · Node.js SDK · 错误处理。