RebarViz

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 的设置页， 项目才能代表你去调用对应模型。

API Key 不等于聊天会员，也不等于手机号验证码。它通常只在服务商自己的开发者平台里生成。

3. 为什么配置了 Key 还不能用

最常见的原因有 4 个：Key 填错、Key 已失效、账号没有余额或没开通计费、当前模型没有访问权限。

最常见的是第三种：只创建了 Key，但账户没有余额。很多服务商的 API 是按调用计费的， 所以没有额度时，接口也会直接失败。

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. 推荐给新手的最短路径

  1. 选一个服务商。
  2. 去服务商官网注册开发者账号。
  3. 确认账号已经有余额，或者已经开通计费。
  4. 创建 API Key。
  5. 回到 RebarViz 设置页粘贴 Key。
  6. 点击“测试连接”。
  7. 测试通过后再开始使用 AI 助手。

7. 测试连接失败时怎么排查

  • 检查 Key 是否复制完整，前后有没有多余空格。
  • 确认服务商后台已经开通 API 服务，不只是注册了账号。
  • 确认账户有余额，或者已经绑定支付方式并开通计费。
  • 确认当前默认模型对你的账号可用。
  • 如果还是失败，重新生成一个新的 API Key 再测试。

8. 安全提醒

不要把 API Key 发给别人，也不要把 API Key 提交到 Git 仓库里。当前 RebarViz 的设计是把 Key 保存在浏览器本地，不上传到服务器，但你仍然应该把它当成密码一样保管。

一句话总结

API Key 只是钥匙，账户余额才是油箱。没有余额，很多接口就算 Key 正确也跑不起来。