OpenAI 兼容接入指南

本文介绍如何将森课帮接入所有支持 OpenAI 协议的工具和代码。

这篇文档适合谁？

如果你正在使用的工具支持以下任意一种配置方式，这篇文档就可以直接套用：

• OpenAI
• OpenAI Compatible
• Custom OpenAI
• 自定义 OpenAI 提供商
• 允许你手动填写 Base URL 和 API Key

典型工具包括：Cline、Dify、n8n、Chatbox、CherryStudio，以及大部分支持 OpenAI 协议的 AI 客户端和工作流工具。

---

你只需要准备 3 个值

字段	填什么	示例
Base URL	森课帮的 OpenAI 兼容地址	https://senkebang.cn/v1
API Key	你在森课帮控制台创建的密钥	sk-xxxxxxxx
Model	完整 API 模型 ID	openai/gpt-4o / anthropic/claude-sonnet-4.5

注意：模型名称格式

森课帮的模型名需要写完整的 厂商/模型名，例如：

• ✅ 正确：openai/gpt-4o
• ❌ 错误：gpt-4o

---

不同工具里的字段通常长什么样？

工具里的字段名	你应该填写的内容
API Provider / Provider	选择 OpenAI、OpenAI Compatible 或 Custom OpenAI
Base URL / API Base URL / Endpoint	https://senkebang.cn/v1
API Key / Bearer Token	你的森课帮 API Key
Model / Model ID	完整模型名，如 openai/gpt-4o
Organization ID	一般留空即可

---

通用填写模板

1. 在工具里选择 OpenAI 或 OpenAI Compatible 类型的提供商
2. 将 Base URL 填为 https://senkebang.cn/v1
3. 将 API Key 填为你在森课帮创建的密钥
4. 将模型填写为完整模型 ID
5. 点击测试、保存，或直接发一条消息验证

---

什么时候用 Chat Completions，什么时候用 Responses？

场景	建议接口
大多数聊天工具、IDE 插件、工作流节点	Chat Completions（/chat/completions）
工具允许你手动指定原始接口，且你要调用 GPT-5.x 系列模型	Responses API（/responses）

💡 GPT-5.x 兼容性提示 像 openai/gpt-5.2-chat 这类 GPT-5.x 模型，请优先使用 Responses API，不要走 Chat Completions。

---

代码示例

Chat Completions 示例

curl https://senkebang.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [
      {"role": "user", "content": "你好，请用一句话介绍你自己"}
    ]
  }'

Responses API 示例

curl https://senkebang.cn/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "openai/gpt-5.2-chat",
    "input": "请把森课帮 API 的接入方式总结成 3 个要点"
  }'

---

常见问题

Q1：提示 401 Unauthorized

通常是下面几种原因：

• API Key 复制错了
• Key 前后有空格或换行
• 没有使用 Bearer 方式传 Authorization 头

Q2：提示模型不存在

请检查模型名是否写成了完整格式，例如：

• ✅ 正确：openai/gpt-4o
• ❌ 错误：gpt-4o

Q3：工具里只有 OpenAI，没有 OpenAI Compatible

通常也可以直接用，只要这个工具允许你填写自定义 Base URL。如果它完全不允许改地址，就不适合直接接森课帮。

Q4：工具提示 QPS 超限

请检查该 API 的并发限制，适当降低请求频率，或在 高级配置 中了解如何申请更高的 QPS 配额。

---

下一步推荐

需求	教程
接入 AI 编程助手	OpenAI Codex
接入 AI Agent	OpenClaw
接入桌面客户端	Cherry Studio
直接写代码调用	API 调用参考
查看更多 FAQ	常见问题