外观
接口地址要不要加 /v1?
接入后请求返回 404 Not Found,最常见的原因是 Base URL 里的 /v1 写错了:该加的没加,或者客户端已经自动拼接了 /v1,你又手动加了一次。
为什么会 404
客户端会把 Base URL 和接口路径拼在一起再发请求。不同协议、不同客户端拼接的方式不一样:
| 你填的 Base URL | 客户端拼接的路径 | 实际请求 | 结果 |
|---|---|---|---|
https://api.niceai.dev | /v1/messages(Anthropic) | https://api.niceai.dev/v1/messages | 正常 |
https://api.niceai.dev/v1 | /v1/messages(Anthropic) | https://api.niceai.dev/v1/v1/messages | 404 |
https://api.niceai.dev/v1 | /chat/completions(OpenAI) | https://api.niceai.dev/v1/chat/completions | 正常 |
https://api.niceai.dev | /chat/completions(OpenAI) | https://api.niceai.dev/chat/completions | 404 |
一句话:Anthropic 协议不加 /v1,OpenAI 兼容协议加 /v1,直接请求 Gemini 接口用 /v1beta。例外是会自动补全路径的客户端,以它的说明为准。
各客户端该怎么填
| 客户端 / SDK | 协议 | 接口地址 |
|---|---|---|
Claude Code(ANTHROPIC_BASE_URL) | Anthropic | https://api.niceai.dev |
| Anthropic SDK(Python / Node) | Anthropic | https://api.niceai.dev |
Codex CLI(config.toml 的 base_url) | OpenAI Responses | https://api.niceai.dev/v1 |
| CC Switch 中的 Codex 供应商 | OpenAI Responses | https://api.niceai.dev(CC Switch 会自动补全 /v1) |
| OpenAI SDK(Python / Node) | OpenAI 兼容 | https://api.niceai.dev/v1 |
| Cursor、Cline、Roo Code、Kilo Code、Continue、LobeChat、Dify、n8n、Aider、OpenCode、Open WebUI、Obsidian Copilot 等 | OpenAI 兼容 | https://api.niceai.dev/v1 |
| Cherry Studio | OpenAI 兼容 | https://api.niceai.dev(会自动补 /v1) |
| ChatBox | OpenAI 兼容 | API 主机 https://api.niceai.dev,API 路径留空 |
| NextChat | OpenAI 兼容 | https://api.niceai.dev(会自动补 /v1) |
| 沉浸式翻译 | OpenAI 兼容 | 完整地址 https://api.niceai.dev/v1/chat/completions |
| VS Code Copilot(Custom Endpoint) | 多协议 | 建议填完整地址,如 https://api.niceai.dev/v1/chat/completions 或 https://api.niceai.dev/v1/messages |
| Zed | OpenAI 兼容 / Anthropic | OpenAI 兼容填 https://api.niceai.dev/v1,Anthropic 填 https://api.niceai.dev |
Gemini CLI(GOOGLE_GEMINI_BASE_URL)/ CC Switch | Gemini | https://api.niceai.dev(SDK 会自动补 /v1beta) |
| 直接请求 Gemini REST 接口 | Gemini | https://api.niceai.dev/v1beta |
| Magpie | 多协议 | 一键导入会自动填写,见 Magpie 教程 |
填的是「完整接口地址」还是「Base URL」?
少数客户端要求填写完整接口地址(例如以 /chat/completions 结尾)。如果设置项的说明写的是 Endpoint 或「完整地址」,就填 https://api.niceai.dev/v1/chat/completions;写的是 Base URL 或 API Host,就按上表填写。
自己测一下地址
用 curl 直接请求,可以排除客户端配置的干扰。把 $NICEAI_API_KEY 换成你的密钥。
OpenAI 兼容协议(列出模型):
bash
curl https://api.niceai.dev/v1/models \
-H "Authorization: Bearer $NICEAI_API_KEY"Anthropic 协议:
bash
curl https://api.niceai.dev/v1/messages \
-H "x-api-key: $NICEAI_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model": "<模型名,见模型广场>", "max_tokens": 64, "messages": [{"role": "user", "content": "你好"}]}'curl 能通、客户端仍然 404,基本可以确定是客户端里的 Base URL 多拼或少拼了 /v1。
其他会导致 404 的情况
- 地址末尾多了
/,部分客户端拼接后会变成//v1。 - 把 Anthropic 地址填进了 OpenAI 兼容客户端,或者反过来。
- 模型名写错,部分接口会以 404 返回「模型不存在」。模型名请以 模型广场 为准。
- 密钥分组不支持当前协议,例如用 OpenAI 分组的密钥去请求 Anthropic 接口。分组说明见 分组与倍率说明。