拿到一个新的API中转站，第一件事就是把它塞进你最顺手的客户端。Obsidian、NextChat、ChatBox、LobeChat……我们今天就用云雾AI中转站跑一遍，专门讲讲云雾APIObsidian的参数配置、请求格式、认证方式以及常见错误排查。全程干货，直接能用。

云雾APIObsidian的核心就是通过一套标准的API接口，把云端500+模型的能力接入你的Obsidian笔记。无论你是用Smart Connections、Copilot还是自定义插件，只要配置好云雾AI中转站官网提供的地址和密钥，就能流畅调用GPT-4o、Claude 3.5、Gemini 2.0等主流模型。下面我们一步步拆解参数和格式。

请求格式：标准OpenAI兼容

云雾APIObsidian完全兼容OpenAI API格式，因此你可以在Obsidian中直接使用默认的API端点配置。请求地址为 https://api.yunwuai.cc/v1/chat/completions，方法为POST。请求体JSON结构如下：

{
  "model": "gpt-4o",
  "messages": [
    {"role": "system", "content": "你是一个AI助手"},
    {"role": "user", "content": "总结这段笔记"}
  ],
  "temperature": 0.7,
  "max_tokens": 2000
}

注意云雾APIObsidian支持所有OpenAI参数（stream、top_p、frequency_penalty等），但需要额外添加一个非必填字段 "provider": "yunwu" 来启用专属路由优化——这能帮你获得更低延迟和更稳定的连接。如果你的插件只认官方格式，不填它也完全没问题。

认证方式：API Key 安全接入

认证采用标准的Bearer Token方式。你需要在HTTP请求头中加入：

Authorization: Bearer sk-your-api-key-here

API Key可以在云雾AI中转站官网的“密钥管理”页面生成。建议创建一个专用密钥用于Obsidian插件，并在插件设置中填写。注意：密钥需要与请求地址中的 https://api.yunwuai.cc/v1 匹配，不要混用其他站点的地址。如果你的Obsidian插件（比如“Copilot”或“Text Generator”）要求填入API Base URL，请填写 https://api.yunwuai.cc/v1；如果要求填入完整端点，则填 https://api.yunwuai.cc/v1/chat/completions。两种方式均可正常工作。

常见错误排查

• 401 Unauthorized：API Key错误或未填写。请检查密钥是否完整复制，注意不要有空格。如果是刚生成的密钥，等1分钟再试。
• 429 Too Many Requests：并发过高或余额不足。云雾APIObsidian对普通用户限制20 RPM（每分钟请求数），如果频繁触发，请降低插件中的并发设置。同时检查账户余额——支持支付宝、微信、USDT充值，非常方便。
• 400 Bad Request：请求体参数错误。最常见的是model名称拼写错误，比如把“gpt-4o”写成了“gpt4o”。建议先在云雾AI中转站官网的模型列表页复制规范的模型名。
• Connection Timeout / ECONNREFUSED：网络问题。检查你的代理或防火墙是否放行 api.yunwuai.cc。另外，Obsidian某些插件会使用系统代理，建议在插件设置中手动指定代理地址。如果依然不行，尝试更换DNS为8.8.8.8。
• Stream 中断或返回空内容：大多是网络不稳定导致。可以关闭stream（设置stream: false）改用一次性返回，或者更换线路。云雾APIObsidian提供高速稳定的全球专享节点，更换后体验显著提升。

除了以上常见问题，云雾APIObsidian还内置了详细的错误日志。你可以在Obsidian的开发者工具（Ctrl+Shift+I）中查看网络请求响应体，里面有具体的错误码和提示。如果问题仍然无法解决，建议到官网的“帮助中心”提交工单，通常1小时内回复。

为什么选择云雾 AI 中转站？

🚀 高速稳定：自建专线节点，延迟低至50ms，告别频繁断连。🧩 500+ 模型：从GPT-4o、Claude 3.5到Gemini Pro、Llama 3，覆盖所有主流大模型。💰 低价：GPT-4o官方价格的1/3，还经常有充值赠送活动。🌍 全球专享：国内用户无需翻墙即可稳定使用，海外用户也有本地加速节点。

目前注册即送5元体验金，支持支付宝、微信、USDT三种支付方式，安全快捷。别再让API配置耽误你的工作流了，把Obsidian变成你的AI第二大脑吧！

已有账号？直接登录开始配置你的云雾APIObsidian