LiteLLM 常见报错处理

启动时报 YAML 错误

检查缩进和冒号。YAML 对缩进敏感，建议用两个空格缩进。

环境变量读取不到

如果配置中使用：

api_key: os.environ/XIKAPI_API_KEY

启动 LiteLLM 的同一个 shell 或服务环境中必须存在 XIKAPI_API_KEY。

下游报 model not found

下游工具填写的是 LiteLLM 的 model_name，不是上游真实模型名。

例如配置里是：

model_name: xikapi-YOUR_MODEL_ID

下游就填：

xikapi-YOUR_MODEL_ID

401 Unauthorized

可能是两层 Key 混淆：

• 上游 Xikapi Key 用在 LiteLLM 配置里。
• 下游 proxy key 用在客户端里。

404 Not Found

检查 api_base：

api_base: https://xikapi.com/v1

不要写成具体接口路径。