指南目录(34 篇)
通用
OpenAI 兼容 API 通用教程:curl 探活、Cherry Studio 与客户端接入
国内外大多数大模型平台都采用 OpenAI 兼容接口:搞清 Base URL 路径拼接规则、用一行 curl 验证密钥可用,就能顺利填进 Cherry Studio、Cline、OpenCode 等工具。
- 适用对象
- 刚拿到平台 API Key,准备填进桌面聊天软件或代码编辑器的人
- 预计用时
- 约 5 分钟
- 更新时间
准备
- 任意一家平台的 API Key(各平台地址可在 免费 AI API 汇总页 一键复制)
- 已安装 Cherry Studio、Cline 或 Cursor
步骤
核对三项参数,留意非 /v1 平台的路径尾巴
OpenAI 兼容工具统一要求填
Base URL、API Key和Model ID,但不同平台的接口版本路径不一样:- 硅基流动:
https://api.siliconflow.cn/v1 - 阿里云百炼(北京):
https://dashscope.aliyuncs.com/compatible-mode/v1 - 火山方舟:
https://ark.cn-beijing.volces.com/api/v3/ - 智谱开放平台:
https://open.bigmodel.cn/api/paas/v4/ - 百度千帆:
https://qianfan.baidubce.com/v2/(使用bce-v3/ALTAK-开头的新版 Bearer Key)
绝大多数客户端只需要填到这一截基础地址,发请求时会自动补齐
chat/completions,不要自己把完整路径粘进去导致重复拼接。- 硅基流动:
填软件前先用 curl 测通密钥与模型 ID
客户端报错有时不够直观,建议先在终端用
curl直接请求一次完整端点(curl不会自动补路径,所以这里写全/chat/completions)。下面以硅基流动免充值的XingChenAGI/Xing4.0-29B为例,返回正常 JSON 说明密钥、实名认证和模型名称都没问题:curl https://api.siliconflow.cn/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-你的硅基流动Key" \ -d '{ "model": "XingChenAGI/Xing4.0-29B", "messages": [{"role": "user", "content": "你好"}] }'接入 Cherry Studio(善用内置列表与斜杠规则)
打开 Cherry Studio 左下角 设置 → 模型服务:
- 内置服务商(如硅基流动、火山引擎、智谱):直接点选对应名字,粘入 API Key,点底部 管理 把模型加入「我的模型」即可(有多把同平台 Key 时,用英文逗号
,隔开填入就能自动轮询)。 - 手动添加自定义 OpenAI 服务商:点底部 添加,类型选 OpenAI。如果对方是
/v2、/v3、/v4这类非/v1路径,在 API 地址末尾保留一个斜杠/(例如https://ark.cn-beijing.volces.com/api/v3/),Cherry Studio 就会直接在其后拼接chat/completions而不会误加/v1;若某个网关要求原样使用完整地址不做任何拼接,在完整路径末尾加#即可。
- 内置服务商(如硅基流动、火山引擎、智谱):直接点选对应名字,粘入 API Key,点底部 管理 把模型加入「我的模型」即可(有多把同平台 Key 时,用英文逗号
接入编程工具(Cline / OpenCode / Cursor)
- Cline 与 OpenCode:免费支持接入任意 OpenAI 兼容接口,把同一套 Base URL、API Key 和支持工具调用的 Model ID 填入即可。
- Cursor(仅限付费套餐):只有订阅了 Cursor Pro 及以上套餐的用户,才能在
Cursor Settings → Models里开启OpenAI API Key与Override OpenAI Base URL调用第三方模型(且仅对右侧对话面板生效,Tab 补全仍走内置模型)。免费版账号锁死 Auto 模式,详见 Cursor 自定义 Key 说明。
注意事项
- 模型 ID 区分大小写与厂商前缀(例如硅基流动不带
Pro/的是免费模型,带Pro/前缀的同名模型会扣代金券或余额),直接从平台模型页复制最稳妥。 - 用新人免费额度跑高频工具前,先在平台侧打开防超额开关(如火山方舟「安心体验模式」、阿里云百炼「免费额度用完即停」)。
常见问题
为什么服务商类型选了 OpenAI,调用的却是国内模型?
选 OpenAI 只是指定请求体和响应体的数据格式;请求实际发往哪家服务器、扣哪家的额度,完全取决于你填写的 Base URL 与 API Key。
curl 能正常回复,填进编程 Agent 却报 400 错误?
curl 示例只发了纯文本消息,而编程 Agent 会附带 tools 函数调用参数。如果所选模型不支持 Function Calling,或者客户端默认传入的 max_tokens 超出模型上限,就会返回 400。
相关优惠
- 额度智谱智谱 ZCode 周末 5 亿 GLM-5.3-Flash Tokens:11 月 20 日 23:00 至周一 9 点免费领 5 亿 GLM-5.3-Flash Tokens,周末可用至周一 9 点
- 折扣智谱智谱 GLM-5.3-Flash 限时五折:输入 0.4 元/百万 TokensGLM-5.3-Flash 限时五折:输入 0.4 元、缓存命中 0.115 元、输出 1.4 元/百万 Tokens
- 新人智谱智谱开放平台新用户送 2000 万 Tokens 体验包新用户注册送 2000 万 Tokens 体验包,另有 120 次图像和视频资源包
- 新人百度百度千帆新用户每款预置模型送 100 万 Tokens,有效期 3 个月17 款预置模型各送 100 万 Tokens,合计 1700 万,有效期 3 个月
- 模型百度百度文心 5.5 Flash 预览版限时免费:在OpenRouter 与 Kilo Code 可用文心 5.5 Flash 预览版免费,输入输出都免费,1M 上下文,OpenRouter 与 Kilo Code 双路由
- 折扣火山引擎豆包大模型 2.1 资源包 19 元约 440 万 Tokens,原价 38 元19 元约 440 万 Tokens(原价 38 元,半价)
参考链接
- Cherry Studio 模型服务商与地址规则文档docs.cherryai.com.cn/pre-basic/providers
- 火山方舟接入三方工具说明docs.volcengine.com/docs/ark/integrate-third-party-tools
- 硅基流动快速上手文档docs.siliconflow.cn/cn/userguide/quickstart
- Cursor 官方文档 Bring your own API keycursor.com/docs/settings/api-keys