.llm.api] API returned empty model list（已回退到默认的 2 个模型）

2026年06月20日 20:21 22.17 秒 success

错误信息

获取模型列表失败：API错误: [error.llm.api] API returned empty model list（已回退到默认的 2 个模型）

AI 解决方案

● AI 思考过程 ▼

好的，用户提供了一个API错误信息，说获取模型列表失败了，API返回了空的模型列表，然后系统回退到了默认的两个模型。

用户现在是DMXAPI平台的开发者或者用户，遇到了技术问题，需要我来分析。我的核心任务就是分析代码报错，所以这个请求完全符合要求。

我先来翻译错误信息，把关键部分原文和译文放在一起。错误信息是“API returned empty model list”，中文意思就是“API返回了空的模型列表”。这样用户就能清楚看到问题的核心了。

接下来要分析原因。API返回空列表，最可能的原因是API密钥配置错了，或者网络连接有问题，也有可能是账户没有权限访问模型列表。API端本身出故障也有可能，但作为分析助理，我更应该从用户侧可控的因素来考虑。

对于解决方案，我需要给出具体步骤。首先应该检查API密钥，确保配置正确。然后测试网络连通性，看看能不能正常访问API端点。还要确认账户的权限是否足够。如果这些都没问题，可能需要在代码里添加错误处理逻辑，比如重试机制或者更详细的日志记录。

最后要提供预防措施。用户应该确保配置信息准确，可以在代码中添加健康检查机制，同时实现完善的日志系统，这样以后再出问题就更容易排查了。

整个思考过程要聚焦在技术分析上，避免任何多余的客套话，直接针对问题给出专业建议。

🌐 错误翻译

原文：API returned empty model list
译文：API返回了空的模型列表

🎯 原因分析

API调用返回了空的模型列表，这通常由以下几种原因导致：

API密钥或权限问题：提供的API密钥无效、已过期，或关联的账户/项目没有获取模型列表的权限。

网络或连接问题：调用API端点时网络不稳定，或请求被防火墙、代理拦截。

API端服务异常：对方API服务暂时不可用或其数据接口存在问题。

💡 解决方案

请按顺序检查以下项：

核对API密钥

检查代码或配置文件中用于调用该API的密钥是否正确、是否已过期或是否被撤销。

# 例如，在环境变量中检查 echo $LLM_API_KEY

验证网络连接与端点

curl

    # 示例：用curl测试API连通性（请替换实际的URL和头信息）
    curl -X GET "https://api.example.com/v1/models" \
         -H "Authorization: Bearer YOUR_API_KEY"

检查代码逻辑

确保代码中发送请求的URL、请求头（如Authorization）、参数均正确无误。
🛡️ 预防措施

配置校验

增加健壮性处理：在代码中实现重试机制和更详细的日志记录，便于快速定位是网络问题、认证问题还是服务端问题。

    # 伪代码示例：带重试和日志的API调用
    import requests
    import logging

    def get_models_with_retry(api_url, headers, max_retries=3):
        for attempt in range(max_retries):
            try:
                response = requests.get(api_url, headers=headers, timeout=10)
                response.raise_for_status() # 检查HTTP错误
                models = response.json().get('models', [])
                if models: # 检查列表是否非空
                    return models
                else:
                    logging.warning(f"API返回空模型列表，尝试：{attempt+1}")
            except requests.exceptions.RequestException as e:
                logging.error(f"API请求失败: {e}")
        logging.error("达到最大重试次数，获取模型列表失败")
        return []

分析新问题查看更多