Source: https://wiki.niceai.dev/guide/v1-404

# 接口地址要不要加 /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 教程](https://wiki.niceai.dev/guide/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 返回「模型不存在」。模型名请以 [模型广场](https://niceai.dev/model-plaza) 为准。
- 密钥分组不支持当前协议，例如用 OpenAI 分组的密钥去请求 Anthropic 接口。分组说明见 [分组与倍率说明](https://wiki.niceai.dev/guide/billing-groups)。

## 下一步

- [Claude Code 接入](https://wiki.niceai.dev/guide/claude-code)
- [Codex CLI 接入](https://wiki.niceai.dev/guide/codex)
- [常见错误码对照](https://wiki.niceai.dev/guide/error-codes)
- [支持的客户端一览](https://wiki.niceai.dev/guide/clients/)
- [同一个 API，为什么各个工具的 Base URL 写法都不一样](https://wiki.niceai.dev/guide/tech/base-url-rules)
