RebarViz Help
AI 助手 API 配置帮助
这份说明是给第一次接触 AI 接口的用户准备的。重点只讲 3 件事: ` API 是什么 `、` API Key 是什么 `、以及为什么配置了 Key 以后仍然可能不能用。
1. API 是什么
API 可以理解成“程序调用 AI 服务的入口”。RebarViz 里的 AI 助手不是直接内置在网页里的, 它需要去调用第三方 AI 服务商的模型。
调用这些模型时,通常需要两样东西:`API Key` 和 `账户余额 / 可用额度`。
2. API Key 是什么
API Key 就像一把“调用权限钥匙”。你在服务商官网创建 Key 后,把它填到 RebarViz 的设置页, 项目才能代表你去调用对应模型。
3. 为什么配置了 Key 还不能用
最常见的原因有 4 个:Key 填错、Key 已失效、账号没有余额或没开通计费、当前模型没有访问权限。
4. 充值在哪里充
充值不是在 RebarViz 里充,而是在各 AI 服务商官网后台充值,或者绑定支付方式并开通 billing。
一般正确流程是:注册账号、开通 API、充值或绑定支付方式、创建 API Key、回到 RebarViz 粘贴并测试。
5. 各服务商使用提醒
DeepSeek
需要在 DeepSeek 开发者平台创建 API Key,并确认账户有余额。
通义千问 Qwen
需要在阿里云 DashScope 后台开通 API 服务,并准备可用额度。
Kimi
需要在月之暗面开放平台创建 API Key,并确认账户额度可用。
OpenAI
要在 OpenAI Platform 配置,不是 ChatGPT 网页会员本身;通常还要开通 billing。
6. 推荐给新手的最短路径
- 选一个服务商。
- 去服务商官网注册开发者账号。
- 确认账号已经有余额,或者已经开通计费。
- 创建 API Key。
- 回到 RebarViz 设置页粘贴 Key。
- 点击“测试连接”。
- 测试通过后再开始使用 AI 助手。
7. 测试连接失败时怎么排查
- 检查 Key 是否复制完整,前后有没有多余空格。
- 确认服务商后台已经开通 API 服务,不只是注册了账号。
- 确认账户有余额,或者已经绑定支付方式并开通计费。
- 确认当前默认模型对你的账号可用。
- 如果还是失败,重新生成一个新的 API Key 再测试。
8. 安全提醒
不要把 API Key 发给别人,也不要把 API Key 提交到 Git 仓库里。当前 RebarViz 的设计是把 Key 保存在浏览器本地,不上传到服务器,但你仍然应该把它当成密码一样保管。
一句话总结
API Key 只是钥匙,账户余额才是油箱。没有余额,很多接口就算 Key 正确也跑不起来。