OpenAI API 迁移教程

将现有 OpenAI SDK 或应用迁移到 KunAI：替换 Base URL、API Key 与模型 ID，并逐步验证模型列表、对话响应、流式输出和用量记录。

迁移前检查

这套迁移适用于已经使用 OpenAI SDK 或 OpenAI 兼容请求格式的应用。先记录当前使用的接口路径、模型 ID、流式输出、工具调用和超时设置，并保留一份可回退的原配置。

  • 在控制台创建仅供服务端使用的 API Key，不要把密钥写入浏览器代码、公开仓库或日志。
  • 确认应用实际调用的是 Responses、Chat Completions 还是其他端点，迁移时不要同时改动业务请求结构。
  • 列出生产所需的模型、流式输出、JSON 输出、工具调用和上下文长度，作为迁移验收清单。

分步替换 OpenAI 配置

  1. 保留现有 SDK 和请求代码，先把 Base URL 改为 https://kunai.one/v1，避免路径中重复出现 /v1。
  2. 将服务端环境变量中的 API Key 替换为 KunAI 创建的密钥，并按 Authorization: Bearer API_KEY 发送。
  3. 请求 GET https://kunai.one/v1/models，读取当前账户可见的精确模型 ID；不要根据展示名称猜测模型 ID。
  4. 先用短提示词验证一个非流式对话，再分别验证流式输出、工具调用、结构化输出和长上下文。
  5. 检查 HTTP 状态码、响应格式、延迟和用量记录，确认结果符合应用的错误处理与成本预期。
  6. 在小流量验证通过后再扩大使用范围；若关键能力不兼容，恢复保留的 Base URL、密钥引用和模型配置。

常见迁移差异

  • 模型可见范围与模型 ID 以 /v1/models 的实时返回为准，原 OpenAI 模型名不一定可以直接替换。
  • 不同模型对工具参数、结构化输出、图片输入和最大上下文的支持可能不同，应逐项验证而不是只测试普通对话。
  • SDK 若自动拼接接口路径，Base URL 通常填写到 /v1；出现 404 时优先检查重复路径和实际请求地址。

继续阅读