先区分鉴权和额度问题
鉴权失败通常与 API Key 复制错误、分组错误或环境变量未生效有关；额度不足则需要回到 uucode.top 控制台检查余额、体验额度和调用记录。
Key and Credit Troubleshooting
排查 UUcode API Key 无效、额度不足和调用失败
UUcode 快速生图和疑难问题排查文档都强调 Key 分组、复制完整性、模型能力和账号额度。这个页面把“鉴权失败”“key 无效”“无法出图”“调用失败”等搜索意图集中起来。
- Key 完整性
- 额度检查
- 模型能力确认
图像生成要看模型能力
快速生图文档提醒：已配置但无法出图时，要检查模型是否支持图像生成、账号额度是否充足，并重新保存配置后重试。
把排障路径标准化
团队可以把“检查 Key、检查 Base URL、检查环境变量、检查额度、检查模型能力、查看文档”作为 UUcode 工具接入的固定排障顺序。
01
检查 Key 是否完整
确认 API Key 来自 uucode.top 控制台，复制时没有遗漏、换行或多余空格。
02
检查配置位置
Codex 查 auth.json，Claude Code 查环境变量，OpenClaw 查 openclaw.json，生图工具查 api_key/base_url。
03
检查额度和模型
回到控制台查看额度与调用记录，并确认当前模型支持目标能力，例如图像生成。
常见问题
UUcode 鉴权失败最常见原因是什么？
常见原因包括 Key 复制不完整、分组不匹配、Base URL 错误、终端未重启或配置文件位置不对，可继续查看 doc.uucode.top 的疑难问题排查指南。
无法出图一定是 Key 错了吗？
不一定，还需要检查模型是否支持图像生成、账号额度是否充足，以及是否使用 GPT 分组 key。