EZAT RouterDocs

简介

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 提供。当前的模型列表见模型。

Base URL

API 格式Base URL端点
Anthropic Messageshttps://api.router.ezat.ioPOST /v1/messages、POST /v1/messages/count_tokens、GET /v1/models
兼容 OpenAIhttps://api.router.ezat.io/openai/v1POST /chat/completions、GET /models、GET /models/{id}

两者都接受你的 ezat_sk_… key，可以放在 x-api-key 请求头中，也可以用 Authorization: Bearer 发送。见认证。

SDK 会自己补上路径

给 Anthropic SDK 和 Claude Code 填 https://api.router.ezat.io，不带 /v1。给 OpenAI SDK 填 https://api.router.ezat.io/openai/v1，带 /openai/v1。这里填错是最常见的配置错误，见故障排查。

该用哪种格式

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

自己写代码时，优先使用 Anthropic 格式：请求会按你发送的原样到达模型。兼容 OpenAI 的 API 会把每个请求转换成 Anthropic 格式，再把结果转换回来，并且会拒绝少数没有对应项的 OpenAI 字段（见 Chat Completions）。同样的对话，通过两种 API 的费用相同。

获取 API key

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

快速开始会逐步讲解每一步，并带你发送第一个请求。

工作原理

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

联系 support@ezat.io 时，请提供响应头 request-id 的值；如果没有 request-id，提供 x-request-id。见故障排查。

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

下一步

快速开始

注册、创建 key，发送第一个请求。

Claude Code

让 Claude Code 使用你的 EZAT Router 余额运行。

Anthropic Messages

POST /v1/messages、流式输出、token 计数和请求头。

兼容 OpenAI

OpenAI SDK 和工具的 base URL 与配置。

模型

所有可调用的模型，以及它们的 id 和别名。

价格

每百万 token 的价格，并列出官方价格。

给 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/skill/ezat-router.zip 安装 agent 技能。

快速开始

注册、充值、创建 API key，并用 curl、Python 或 TypeScript 发送第一个请求。

本页内容

何时阅读本页EZAT Router 是什么Base URL该用哪种格式获取 API key工作原理下一步给 AI agent 的说明