国内开发者解决ChatGPT API常见错误

openai.APIConnectionError: Connection error.
requests.exceptions.ConnectionError: HTTPSConnectionPool(host='api.openai.com', port=443)

from openai import OpenAI
client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.jiekou.ai/v1"  # 关键：替换base_url
)

import httpx
from openai import OpenAI
client = OpenAI(
    api_key="your-api-key",
    http_client=httpx.Client(
        proxies="http://127.0.0.1:7890"  # 替换为你的代理地址
    )
)

export HTTPS_PROXY=http://127.0.0.1:7890

openai.AuthenticationError: 401 Incorrect API key provided
openai.AuthenticationError: No API key provided

# 错误示范：硬编码且可能包含空格
api_key = " sk-xxxx "  # 注意两端的空格！
# 正确做法：使用strip()去除空白字符
import os
api_key = os.environ.get("OPENAI_API_KEY", "").strip()
client = OpenAI(api_key=api_key)

openai.RateLimitError: Rate limit reached for gpt-4o
openai.RateLimitError: You exceeded your current quota

import time
from openai import OpenAI, RateLimitError
client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.jiekou.ai/v1"
)
def chat_with_retry(message, max_retries=5):
    for i in range(max_retries):
        try:
            response = client.chat.completions.create(
                model="gpt-4o",
                messages=[{"role": "user", "content": message}]
            )
            return response.choices[0].message.content
        except RateLimitError as e:
            if i < max_retries - 1:
                wait_time = 2 ** i  # 指数退避：1, 2, 4, 8, 16秒
                print(f"触发限速，{wait_time}秒后重试...")
                time.sleep(wait_time)
            else:
                raise e

openai.APITimeoutError: Request timed out.

from openai import OpenAI
client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.jiekou.ai/v1",
    timeout=60.0  # 设置更长的超时时间（默认600秒）
)
# 或者在单次请求中设置
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "写一篇长文章..."}],
    timeout=120.0  # 单次请求超时
)

stream = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "写一篇长文章..."}],
    stream=True
)
for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

openai.BadRequestError: 400 Bad request

# 错误：缺少role字段
messages = [{"content": "你好"}]
# 正确：必须包含role
messages = [{"role": "user", "content": "你好"}]

# 错误：model名称拼写错误
model = "gpt4o"  # 错！
model = "GPT-4o"  # 错！
# 正确
model = "gpt-4o"

# gpt-4o最大输出16384 tokens
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[...],
    max_tokens=4096  # 合理范围内
)

openai.BadRequestError: This model's maximum context length is 128000 tokens. 
However, your messages resulted in 150000 tokens.

import tiktoken
def count_tokens(messages, model="gpt-4o"):
    """计算消息列表的Token数量"""
    encoding = tiktoken.encoding_for_model(model)
    num_tokens = 0
    for message in messages:
        num_tokens += 4  # 每条消息的固定开销
        for key, value in message.items():
            num_tokens += len(encoding.encode(value))
    return num_tokens
def trim_messages(messages, max_tokens=100000):
    """裁剪历史消息，保持在Token限制内"""
    system_msg = [m for m in messages if m["role"] == "system"]
    other_msgs = [m for m in messages if m["role"] != "system"]
    
    while count_tokens(system_msg + other_msgs) > max_tokens and len(other_msgs) > 1:
        other_msgs.pop(0)  # 删除最早的消息
    
    return system_msg + other_msgs

Error 403: Access denied
openai.PermissionDeniedError: 403

openai.NotFoundError: The model 'gpt-4' does not exist

# OpenAI官方模型（通过jiekou.ai支持）
MODELS = {
    "最新旗舰": "gpt-4o",
    "快速版": "gpt-4o-mini",
    "推理模型": "o3",
    "经济型": "gpt-3.5-turbo",
}
# jiekou.ai额外支持
EXTRA_MODELS = {
    "Claude": "claude-3-5-sonnet-20241022",
    "Gemini": "gemini-1.5-pro",
}

openai.BadRequestError: The response was filtered due to the prompt triggering Azure OpenAI's content management policy.
openai.BadRequestError: This request has been blocked by our content filters.

from openai import OpenAI
# 一行代码解决网络问题
client = OpenAI(
    api_key="your-api-key",
    base_url="https://api.jiekou.ai/v1"
)
# 后续代码与官方API完全一致