Skip to content

接口地址要不要加 /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/messages404
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/completions404

一句话:Anthropic 协议不加 /v1,OpenAI 兼容协议加 /v1,直接请求 Gemini 接口用 /v1beta。例外是会自动补全路径的客户端,以它的说明为准。

各客户端该怎么填 ​

客户端 / SDK协议接口地址
Claude Code(ANTHROPIC_BASE_URL)Anthropichttps://api.niceai.dev
Anthropic SDK(Python / Node)Anthropichttps://api.niceai.dev
Codex CLI(config.toml 的 base_url)OpenAI Responseshttps://api.niceai.dev/v1
CC Switch 中的 Codex 供应商OpenAI Responseshttps://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 StudioOpenAI 兼容https://api.niceai.dev(会自动补 /v1)
ChatBoxOpenAI 兼容API 主机 https://api.niceai.dev,API 路径留空
NextChatOpenAI 兼容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
ZedOpenAI 兼容 / AnthropicOpenAI 兼容填 https://api.niceai.dev/v1,Anthropic 填 https://api.niceai.dev
Gemini CLI(GOOGLE_GEMINI_BASE_URL)/ CC SwitchGeminihttps://api.niceai.dev(SDK 会自动补 /v1beta)
直接请求 Gemini REST 接口Geminihttps://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 接口。分组说明见 分组与倍率说明。

下一步 ​

NiceAI · 稳定的 AI 大模型 API 中转站