赛博鸡蛋
指南目录(34 篇)

通用

OpenAI 兼容 API 通用教程:curl 探活、Cherry Studio 与客户端接入

国内外大多数大模型平台都采用 OpenAI 兼容接口:搞清 Base URL 路径拼接规则、用一行 curl 验证密钥可用,就能顺利填进 Cherry Studio、Cline、OpenCode 等工具。

适用对象
刚拿到平台 API Key,准备填进桌面聊天软件或代码编辑器的人
预计用时
约 5 分钟
更新时间

准备

步骤

  1. 核对三项参数,留意非 /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,不要自己把完整路径粘进去导致重复拼接。

  2. 填软件前先用 curl 测通密钥与模型 ID

    客户端报错有时不够直观,建议先在终端用 curl 直接请求一次完整端点(curl 不会自动补路径,所以这里写全 /chat/completions)。下面以硅基流动免充值的 XingChenAGI/Xing4.0-29B 为例,返回正常 JSON 说明密钥、实名认证和模型名称都没问题:

    bash
    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": "你好"}]
      }'
  3. 接入 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;若某个网关要求原样使用完整地址不做任何拼接,在完整路径末尾加 # 即可。
  4. 接入编程工具(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。

相关优惠

参考链接

相关指南

搜索优惠

提交优惠线索

粘贴官方活动页、定价页或文档链接,每日定时核验通过后发布。

无需注册,提交后可查看审核进度