2.1 KiB
2.1 KiB
V0 接口问题结论与操作清单
经完整测试与排查后的结论，以及「确保可用」的配置与操作。
一、测试结论
| 项目 | 结果 | 说明 |
|---|---|---|
| API Key | 有效 | GET https://api.v0.dev/v1/models 返回 200，可拉取模型列表（v0-1.0-md, v0-1.5-md, v0-1.5-lg） |
| Chat Completions | 当前 500 | POST …/chat/completions 返回 {"success":false,"error":"Unknown error"}，属 v0 服务端/账号侧 问题 |
| 可能原因 | 套餐/额度/计费 | 官方要求 Premium 或 Team + usage-based billing 开启；额度用尽或未开通会致 completions 报错而 /models 仍正常 |
二、你需要做的（让 V0 完全可用）
- 登录 v0.app（与当前 API Key 对应账号）。
- 打开 Billing / 计费：确认已开通 Premium 或 Team。
- 确认 Usage-based billing（按量计费） 已开启（Model API 必需）。
- 查看 Usage / 用量：若当月额度已用尽，需充值或等下月重置。
- 若修改过 Key 或套餐，在 ClawX 或
~/.openclaw/openclaw.json中更新custom-custom21.apiKey后重启网关。
完成以上后，再运行 bash 运营中枢/工作台/scripts/test_v0_api.sh，应出现「Completions 可用」。
三、确保可用（不依赖 V0）
以下已落实，无需 V0 时 ClawX 也可正常使用：
- 默认主模型：
~/.openclaw/openclaw.json中agents.defaults.model.primary=ollama/qwen2.5:3b，即本地 Ollama。 - 回退：fallbacks 含
custom-custom21/v0-1.5-md等；若选 V0 且 V0 报错，在对话中改选「本地小模型 3B」即可。 - 检测脚本：
运营中枢/工作台/scripts/test_v0_api.sh先验 Key 再验 completions，并给出明确排查提示。
四、相关文档与脚本
- 参数与设置说明：
ClawX_V0参数说明.md - 对接与常见问题：
参考资料/v0_API对接说明.md（含「Key 有效但 Completions 500」说明） - 检测命令：
bash 运营中枢/工作台/scripts/test_v0_api.sh