API 地址与协议

接入时最常见的错误不是模型名，而是 协议、Base URL 和实际端点不匹配。

协议映射

协议	Base URL	代表端点
OpenAI 兼容	https://aikey365.com/v1	/chat/completions、/responses、/embeddings、/models
Anthropic Messages	https://aikey365.com	/v1/messages
Gemini 原生	https://aikey365.com	/v1beta/models/{model}:generateContent

如果控制台展示了专用 API 地址或区域入口，应以控制台当前值为准。

为什么 OpenAI 常带 /v1

OpenAI SDK 和很多兼容客户端把 Base URL 视为版本前缀，因此常配置为：

https://aikey365.com/v1

随后 SDK 会继续拼接 chat/completions 或 responses。

为什么 Claude Code 常不带 /v1

Anthropic 生态工具通常把根地址作为 Base URL，再请求 /v1/messages。因此常配置：

https://aikey365.com

Gemini 原生

Gemini 原生请求采用 /v1beta/models/... 结构，而不是 OpenAI Chat Completions。

诊断 404

遇到 404 时按顺序检查：

1. 客户端实际发送的协议。
2. Base URL 是否重复或缺少 /v1。
3. 客户端是否自动追加了 chat/completions、responses 或 messages。
4. 代理、网关或企业网络是否改写了路径。

不要用“换模型”来修复路径错误。