AI工具调用失败的常见原因与解决方案：新手避坑指南

1次阅读

共计 2107 个字符，预计需要花费 6 分钟才能阅读完成。

调用 AI 工具时，HTTP 状态码是第一个需要关注的信号。不同的状态码代表着不同的问题类型，理解它们能快速定位问题。

401 Unauthorized：最常见的错误之一，通常意味着 API 密钥无效或未提供认证信息。
检查密钥是否过期或被撤销
确认请求头中 Authorization 字段格式正确（如Bearer your_api_key）
403 Forbidden：权限不足，即使密钥有效也可能触发
账户可能未开通对应服务的访问权限
某些 API 对 IP 地址或调用时间段有限制
429 Too Many Requests：超过速率限制
免费套餐通常有严格的 QPS（每秒查询数）限制
需要实现请求队列或退避重试机制
500 Internal Server Error：服务端问题
可能是 AI 模型加载失败或内部超时
需要与服务提供商确认状态

import time
import requests
from typing import Optional, Dict, Any

def call_with_retry(
    url: str,
    headers: Dict[str, str],
    payload: Dict[str, Any],
    max_retries: int = 3,
    initial_delay: float = 1.0
) -> Optional[Dict[str, Any]]:
    """
    带指数退避的 API 调用
    :param initial_delay: 初始延迟时间（秒）:return: 成功时返回 JSON 响应，失败返回 None
    """
    delay = initial_delay
    for attempt in range(max_retries):
        try:
            response = requests.post(url, json=payload, headers=headers)
            if response.status_code == 200:
                return response.json()

            # 针对特定状态码处理
            if response.status_code == 429:
                print(f'触发限流，第 {attempt+1} 次重试...')
            elif response.status_code >= 500:
                print(f'服务端错误，等待 {delay:.1f} 秒后重试...')

            time.sleep(delay)
            delay *= 2  # 指数退避

        except requests.exceptions.RequestException as e:
            print(f'网络异常: {str(e)}')
            time.sleep(delay)

    print(f'达到最大重试次数{max_retries}')
    return None

永远不要将密钥硬编码在代码中
使用环境变量或密钥管理服务：

import os
from dotenv import load_dotenv

# 从.env 文件加载（开发环境）load_dotenv()  

# 生产环境建议使用：# - AWS Secrets Manager
# - HashiCorp Vault
API_KEY = os.getenv('AI_API_KEY')

headers = {'Authorization': f'Bearer {API_KEY}',
    'Content-Type': 'application/json'
}

import logging
from pprint import pformat

logging.basicConfig(filename='api_calls.log', level=logging.INFO)

def sanitize(data: dict) -> dict:
    """脱敏处理敏感字段"""
    sanitized = data.copy()
    if 'api_key' in sanitized:
        sanitized['api_key'] = '***REDACTED***'
    return sanitized

# 记录请求和响应
logging.info(f'Request: {pformat(sanitize(payload))}')
logging.info(f'Response Status: {response.status_code}')