---
title: Base URL、接口与鉴权
description: 1折AI 的 Base URL、可用接口、请求头写法，以及不同工具里要不要加 /v1。
---

所有请求都发到同一个域名，按协议分两套路径。

```text
https://1zheai.com
```

## 可用接口

| 接口 | 协议 | 用途 |
|---|---|---|
| `POST /v1/messages` | Anthropic 原生 | 对话。Claude Code、Anthropic SDK、Cline（Anthropic 模式）走这里 |
| `POST /v1/chat/completions` | OpenAI 兼容 | 对话。OpenAI SDK、Cursor、Cherry Studio（OpenAI 模式）走这里 |
| `GET /v1/models` | OpenAI 兼容 | 列出你的 API 密钥（API key）能用的模型 |
| `POST /v1/messages/count_tokens` | Anthropic 原生 | 计算一段输入的 token 数，不产生对话，不扣费 |

`count_tokens` 的请求体和 `/v1/messages` 一样（`model`、`messages`，可以带 `system` 和 `tools`），回包只有一个字段：

```json
{"input_tokens":19}
```


`count_tokens` 只数你发送的内容。用 SDK、curl 或第三方工具实际调用时，每次请求还会附带一段系统提示，按输入 token 计费（Claude Code 不附带），见[系统提示的计费](/docs/pricing-explained/#系统提示的计费)。

Prompt Caching、extended thinking、工具调用这些 Claude 特有的能力，用原生 `/v1/messages` 最稳。OpenAI 兼容接口适合已有 OpenAI 代码、只想换个模型的场景。

## 要不要加 /v1

不同工具对 Base URL 的理解不一样，这是接入时最常见的坑：

| 工具 / SDK | 填什么 | 原因 |
|---|---|---|
| Claude Code（`ANTHROPIC_BASE_URL`） | `https://1zheai.com` | 工具自己会拼 `/v1/messages` |
| Anthropic SDK（`base_url`） | `https://1zheai.com` | 同上 |
| OpenAI SDK（`base_url`） | `https://1zheai.com/v1` | SDK 只拼 `/chat/completions` |
| Cursor（Override OpenAI Base URL） | `https://1zheai.com/v1` | 同 OpenAI SDK |
| Cherry Studio | `https://1zheai.com` | 会自动补 `/v1/...` |
| Cline（OpenAI Compatible） | `https://1zheai.com/v1` | 同 OpenAI SDK |

规律：Anthropic 系填根地址，OpenAI 系填到 `/v1`。填错的典型表现是 404。

## 鉴权请求头

API 密钥放在请求头里，两种写法都可以：

<CodeGroup>
```text title="Anthropic 原生"
x-api-key: sk-你的Key
anthropic-version: 2023-06-01
content-type: application/json
```
```text title="Bearer（两种协议都支持）"
Authorization: Bearer sk-你的Key
content-type: application/json
```
</CodeGroup>

- 调 `/v1/messages` 时按官方协议带上 `anthropic-version`，目前的值是 `2023-06-01`。实测不带也能调通，但官方 SDK 和工具都会带，自己写请求时也照带。
- Claude Code 的 `ANTHROPIC_AUTH_TOKEN` 发的是 `Authorization: Bearer`，`ANTHROPIC_API_KEY` 发的是 `x-api-key`，两种我们都认。
- 需要 beta 功能时，照官方文档带上 `anthropic-beta` 头。带上不认识的值不会报错，所以某个 beta 功能是否生效，以回包里的实际效果为准。

## 检查 API 密钥是否可用

```bash
curl https://1zheai.com/v1/models \
  -H "Authorization: Bearer sk-你的Key"
```

返回模型列表说明 API 密钥和地址都对。返回 401 是 API 密钥的问题，回包长这样（2026-10-15 实测）：

```json
{"error":{"code":"","message":"Invalid token (request id: 202610150244361675490398268d9d6eKJPmcph)","type":"authentication_error"}}
```

用 `x-api-key` 和 `anthropic-version` 头请求 `/v1/models` 时，返回的是 Anthropic 格式的模型列表（`data[].id`、`display_name`、`has_more`），Claude Code 的模型自动发现读的就是这个格式。

其它情况见[错误码与排错](/docs/troubleshooting/)。

## 速率限制

目前不对 API 密钥设速率限制。收到 429，通常是上游负载高，稍后重试即可，批量任务加指数退避。详见[错误码与排错](/docs/troubleshooting/)。

## 网络

连接超时或 TLS 报错时，先确认终端走的网络：开着全局代理的话，关掉代理直连再试一次；公司网络有出口白名单的，需要放行 `1zheai.com`。