OpenAI 兼容 API 中的 Model Not Found 错误：原因、修复与调试清单

{
  "error": {
    "message": "The model `gpt-4o` does not exist or you do not have access to it.",
    "type": "invalid_request_error",
    "code": "model_not_found"
  }
}

# 之前：直连 OpenAI
client = OpenAI(api_key="sk-...")

# 之后：切换到另一个提供商但保留了相同的模型 ID
client = OpenAI(
    api_key="your-provider-key",
    base_url="https://api.another-provider.com/v1"  # 已更改
)

response = client.chat.completions.create(
    model="gpt-4o",  # ← 这个模型 ID 在新提供商上可能不工作
    messages=[{"role": "user", "content": "Hello"}]
)

# OpenAI 直连
model = "gpt-4o"

# OpenRouter
model = "openai/gpt-4o"

# 一些提供商使用自己的别名
model = "gpt-4o-2024-08-06"

gpt-4-turbo → 可能重定向或失败，取决于提供商
claude-3-opus-20240229 → 旧版本，可能已被替换

curl https://api.your-provider.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

curl https://api.your-provider.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-model-id",
    "messages": [{"role": "user", "content": "test"}],
    "max_tokens": 5
  }'

MODEL_MAP = {
    "fast-chat": {
        "openai": "gpt-4o-mini",
        "openrouter": "openai/gpt-4o-mini",
        "evolink": "gpt-4o-mini",
    },
    "strong-chat": {
        "openai": "gpt-4o",
        "openrouter": "openai/gpt-4o",
        "evolink": "gpt-4o",
    },
    "reasoning": {
        "openai": "o3",
        "openrouter": "openai/o3",
        "evolink": "o3",
    }
}

def get_model_id(capability: str, provider: str) -> str:
    return MODEL_MAP[capability][provider]

from openai import OpenAI

client = OpenAI(
    api_key="your-evolink-key",
    base_url="https://api.evolink.ai/v1"
)

# 使用标准模型 ID — EvoLink 处理映射
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello"}]
)

response = client.chat.completions.create(
    model="evolink/auto",
    messages=[{"role": "user", "content": "Hello"}]
)

async def validate_models_on_startup(client, required_models: list[str]):
    """启动时调用 /v1/models 并验证所有必需模型是否存在。"""
    available = await client.models.list()
    available_ids = {m.id for m in available.data}

    for model in required_models:
        if model not in available_ids:
            raise RuntimeError(
                f"在提供商上未找到模型 '{model}'。"
                f"可用模型: {sorted(available_ids)}"
            )