错误日志说明

本页解释常见 API 报错，方便用户快速定位问题。

统一接入信息

• 平台名称：FreeDom API
• 控制台 / API Base URL：https://api.yonghu.shop
• 鉴权方式：API Key
• API Key 获取：登录控制台 → 令牌 / API Key 页面创建

401 Unauthorized

含义

认证失败。

常见原因

• API Key 错误
• Key 前后有空格
• 请求头格式不对
• 工具没有保存配置

处理方式

重新复制 Key，并确认请求头为：

Authorization: Bearer 你的_API_Key

403 Forbidden

含义

请求被拒绝。

常见原因

• 余额不足
• Key 没有权限
• 模型未开放
• Key 被禁用

404 Model Not Found

模型不存在或模型名不匹配。请到控制台复制准确模型名。

429 Too Many Requests

请求过快或服务繁忙。建议降低并发、等待重试或切换模型。

500 / 502 / 503

通常是服务繁忙、网络异常或临时故障。建议稍后重试，并保留错误日志反馈客服。

排障顺序

1. 看 URL
2. 看 Key
3. 看模型名
4. 看余额
5. 看 Key 权限和模型权限
6. 看控制台日志

错误码实证补充

当前未带 Key 访问：

curl https://api.yonghu.shop/v1/models

测试返回：

{"error":{"message":"Invalid token ...","type":"new_api_error"}}

这说明 /v1/models 路径存在，但需要合法 API Key。因此用户遇到类似错误时，不应判断为平台挂了，而应先检查 Key。