Base URL、接口与鉴权

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

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

1
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），回包只有一个字段：

1
{"input_tokens":19}

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

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

不同工具对 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 密钥放在请求头里，两种写法都可以：

x-api-key: sk-你的Key
anthropic-version: 2023-06-01
content-type: application/json

Authorization: Bearer sk-你的Key
content-type: application/json

调 /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 功能是否生效，以回包里的实际效果为准。

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

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

1
{"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 的模型自动发现读的就是这个格式。

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

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