> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soloent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API 配置问题

> 解决常见 API 配置问题

解决在 SoloEnt 中设置 API Key 时的常见问题。

## API Key 无效

**问题：** 错误信息显示 "Invalid API key" 或认证失败。

**解决方案：**

* 验证你复制了完整的 Key，没有空格
* 检查 Key 是否已过期或被撤销
* 从供应商控制台重新生成新 Key
* 确保你使用的是该供应商正确的 Key 格式

## 连接失败

**问题：** 无法连接到 AI 模型或请求超时。

**解决方案：**

* 检查你的网络连接
* 验证 Base URL 格式（针对 OpenAI 兼容 API）
* 尝试不使用 VPN 或代理
* 检查供应商服务是否正常运行
* 验证防火墙没有阻止连接

## 超出速率限制

**问题：** 错误信息显示 "Rate limit exceeded" 或 "Too many requests"。

**解决方案：**

* 等待几分钟再重试
* 升级你的 API 计划以获得更高限制
* 暂时切换到其他模型
* 检查供应商控制台的使用限制

## 模型不可用

**问题：** 选择的模型不起作用或返回错误。

**解决方案：**

* 验证模型 ID 是否正确
* 检查你是否有权限访问此模型
* 确保你的 API 层级包含此模型
* 尝试同一供应商的其他模型

## 缺少必填字段

**问题：** 无法保存配置，字段不完整。

**解决方案：**

* 对于标准供应商：只需要 API Key
* 对于 OpenAI 兼容配置：需要全部三个字段（Base URL、API Key、Model ID）
* 仔细检查供应商文档了解确切要求
* 如不确定，联系供应商支持

<Card title="返回 API 配置" icon="key" href="../quickstart/api-configuration">
  返回主要 API 设置指南
</Card>