# 简介

URL: https://docs.router.ezat.io/zh

> EZAT Router 是什么，它的两种 API 格式和各自的 base URL，以及在哪里获取 API key。

## 何时阅读本页

如果你刚开始使用 EZAT Router，或者需要查 base URL、想知道该用哪种 API 格式，请从这里开始。

## EZAT Router 是什么

EZAT Router 让你用一个 API key 和一份预付余额调用领先的 AI 模型。你在控制台充值、创建 key，再把你的工具或 SDK 指向 EZAT Router。每个请求按实际使用的 token 从余额中扣费，没有订阅。

它支持两种 API 格式，使用同一个 key 和同一份余额：

- **Anthropic Messages API**：适用于 Claude Code、Anthropic SDK，以及其他使用 Anthropic 格式的工具。只需更换 base URL 和 key，代码不用改。
- **OpenAI Chat Completions API**：适用于 OpenAI SDK、Cursor、Cline、LangChain 的 OpenAI 客户端，以及其他可以填写 OpenAI base URL 的工具。

模型通过 Amazon Bedrock 提供。当前的模型列表见[模型](https://docs.router.ezat.io/zh/models.md)。

## Base URL

| API 格式 | Base URL | 端点 |
| --- | --- | --- |
| Anthropic Messages | `https://api.router.ezat.io` | `POST /v1/messages`、`POST /v1/messages/count_tokens`、`GET /v1/models` |
| 兼容 OpenAI | `https://api.router.ezat.io/openai/v1` | `POST /chat/completions`、`GET /models`、`GET /models/{id}` |

两者都接受你的 `ezat_sk_…` key，可以放在 `x-api-key` 请求头中，也可以用 `Authorization: Bearer` 发送。见[认证](https://docs.router.ezat.io/zh/authentication.md)。

<Callout type="warn" title="SDK 会自己补上路径">
给 Anthropic SDK 和 Claude Code 填 `https://api.router.ezat.io`，不带 `/v1`。给 OpenAI SDK 填 `https://api.router.ezat.io/openai/v1`，带 `/openai/v1`。这里填错是最常见的配置错误，见[故障排查](https://docs.router.ezat.io/zh/troubleshooting.md)。
</Callout>

## 该用哪种格式

| 你使用的是 | 格式 | Base URL |
| --- | --- | --- |
| Claude Code | Anthropic Messages | `https://api.router.ezat.io` |
| Anthropic SDK（Python、TypeScript 等） | Anthropic Messages | `https://api.router.ezat.io` |
| OpenAI SDK、Cursor、Cline、LangChain 的 OpenAI 客户端、其他 OpenAI 格式的工具 | 兼容 OpenAI | `https://api.router.ezat.io/openai/v1` |
| 你自己写的 HTTP 代码 | 都可以 | 优先用 `https://api.router.ezat.io` |

自己写代码时，优先使用 Anthropic 格式：请求会按你发送的原样到达模型。兼容 OpenAI 的 API 会把每个请求转换成 Anthropic 格式，再把结果转换回来，并且会拒绝少数没有对应项的 OpenAI 字段（见 [Chat Completions](https://docs.router.ezat.io/zh/openai/chat-completions.md)）。同样的对话，通过两种 API 的费用相同。

## 获取 API key

1. 在 `https://router.ezat.io/zh` 登录。首次登录会创建你的账户和第一个组织。
2. 在**账单**页面充值。
3. 在 **API Key** 页面创建 key 并复制。完整的 key 只显示一次。

[快速开始](https://docs.router.ezat.io/zh/quickstart.md)会逐步讲解每一步，并带你发送第一个请求。

## 工作原理

1. **key 属于组织**。组织里的每个 key 都从该组织的余额中扣费。一个人可以属于多个组织，每个组织有各自的 key、余额和用量。见[组织和成员](https://docs.router.ezat.io/zh/organizations.md)。
2. **每个请求都会先经过检查**。EZAT Router 会检查 key、模型、key 的限制，以及余额是否大于零。没有通过检查的请求会被拒绝，不收费。
3. **每个请求按 token 计费**。输入、输出、缓存写入和缓存读取 token 按模型的价格（[价格](https://docs.router.ezat.io/zh/pricing.md)）计费，在请求结束时从余额中扣除。开始时余额为正的请求一定会执行完，所以余额可能略低于零。见[计费方式](https://docs.router.ezat.io/zh/billing.md)。
4. **一切都有记录，除了你的内容**。用量页面会列出每个请求的模型、token 数和费用。提示词和回复从不存储，也不记录日志。

联系 support@ezat.io 时，请提供响应头 `request-id` 的值；如果没有 `request-id`，提供 `x-request-id`。见[故障排查](https://docs.router.ezat.io/zh/troubleshooting.md)。

EZAT Router 是独立运营的服务，与 Anthropic、OpenAI 和 Amazon Web Services 没有隶属关系，也未获得它们的背书。模型名称归各自所有者所有。

## 下一步

<Cards>
  <Card title="快速开始" href="/quickstart">
    注册、创建 key，发送第一个请求。
  </Card>
  <Card title="Claude Code" href="/tools/claude-code">
    让 Claude Code 使用你的 EZAT Router 余额运行。
  </Card>
  <Card title="Anthropic Messages" href="/anthropic/messages">
    `POST /v1/messages`、流式输出、token 计数和请求头。
  </Card>
  <Card title="兼容 OpenAI" href="/openai/base-url">
    OpenAI SDK 和工具的 base URL 与配置。
  </Card>
  <Card title="模型" href="/models">
    所有可调用的模型，以及它们的 id 和别名。
  </Card>
  <Card title="价格" href="/pricing">
    每百万 token 的价格，并列出官方价格。
  </Card>
</Cards>

## 给 AI agent 的说明

1. Anthropic 格式的 base URL：`https://api.router.ezat.io`（不带 `/v1`）。OpenAI 格式的 base URL：`https://api.router.ezat.io/openai/v1`。
2. 以 `x-api-key: $EZAT_API_KEY` 或 `Authorization: Bearer $EZAT_API_KEY` 发送 key。从环境变量 `EZAT_API_KEY` 读取 key；不要让用户把 key 粘贴到对话里。
3. 用 `GET https://api.router.ezat.io/v1/models` 列出模型。不要写死模型列表或价格。
4. 所有页面的索引在 `https://docs.router.ezat.io/llms.txt`，所有页面合成的单个文件在 `https://docs.router.ezat.io/llms-full.txt`。在任意页面 URL 后加上 `.md` 即可获取该页的 Markdown（`https://docs.router.ezat.io/quickstart.md`）。
5. API 规范在 `https://docs.router.ezat.io/openapi.yaml`。
6. 做配置工作时，请按照 [AI agent 须知](https://docs.router.ezat.io/zh/agents.md)操作，或者从 `https://docs.router.ezat.io/skill/ezat-router.zip` 安装 [agent 技能](https://docs.router.ezat.io/zh/agents/skill.md)。