Request timed out.

2026年09月13日 18:57 8.78 秒 success

错误信息

openai.APITimeoutError: Request timed out.

AI 解决方案

原文:openai.APITimeoutError: Request timed out.
译文:OpenAI API超时错误:请求超时。

🎯 原因分析


该错误表示与 OpenAI API 的请求因时间过长未获得响应,达到客户端预设的超时限制。常见原因包括网络波动、服务端响应缓慢或请求参数配置不当。

💡 解决方案


通过显式设置 timeout 参数延长请求超时时间,缓解瞬时网络延迟问题:

import openai

client = openai.OpenAI(api_key="your_api_key", timeout=30.0)

try:
    response = client.chat.completions.create(
        model="gpt-4",
        messages=[{"role": "user", "content": "你好"}],
        timeout=30.0  # 单位为秒,可根据实际情况调整
    )
    print(response.choices[0].message.content)
except openai.APITimeoutError as e:
    print(f"请求超时,请检查网络或稍后重试: {e}")

🛡️ 预防措施


  • 设置合理超时:根据业务场景动态调整超时时间,避免无限等待。

  • 添加重试机制:使用工具库(如 tenacity)实现自动重试,应对临时性网络问题:
  • from tenacity import retry, stop_after_attempt, wait_exponential
    
    @retry(stop=stop_after_attempt(3), wait=wait_exponential(multiplier=1, max=10))
    def safe_request():
        return client.chat.completions.create(...)