NEW原生支持 Claude Code · Codex · Gemini CLI · Grok CLI

一个 Key畅用 Claude

2API 是为 AI 编程工具打造的 API 网关。原生兼容 Anthropic、OpenAI 和 Gemini 协议,Claude Code、Codex、Gemini CLI 改一个 Base URL 就能接入,每次调用的 Token 用量都能逐笔查到。

Claude Code export ANTHROPIC_BASE_URL=https://2api.dev
4
模型家族
3
原生协议
1 行
配置即可切换
Token 级
计费明细

Models · 模型路由表

四大模型家族,同一个入口

Claude、GPT、Gemini、Grok 都按各自的原生协议转发。官方 SDK 和命令行工具怎么调用官方接口,就怎么调用 2API。

2API · Routing table
模型厂商协议端点推荐工具
claude-fable-5-1AnthropicMessages/v1/messagesClaude Code
claude-opus-5-5AnthropicMessages/v1/messagesClaude Code
gpt-6.1-solOpenAIResponses/v1/responsesCodex CLI
gemini-4-agronGoogleGemini/v1beta/modelsGemini CLI
grok-4.7xAIResponses/v1/responsesGrok CLI
claude-sonnet-5-5AnthropicMessages/v1/messagesClaude Code

表中为示例路由,实际可用的模型与价格以 模型广场 为准。

How it works · 请求链路

一次请求,经过网关的四个环节

请求从你的工具发出,到上游返回第一个 Token,网关在中间完成鉴权、调度、转发和计量。

  • CC
    Claude Code/v1/messages
  • CX
    Codex CLI/v1/responses
  • GM
    Gemini CLI/v1beta/models
  • { }
    SDK · HTTP/v1/chat/completions
2API Gatewayrelay
  1. 01鉴权校验 API Key、分组与 IP 白名单
  2. 02调度挑选健康账号,粘性会话保持缓存命中
  3. 03转发原生协议透传,SSE 流式返回
  4. 04计量记录输入、输出与缓存 Token
  • AnthropicClaude
  • OpenAIGPT · Codex
  • GoogleGemini
  • xAIGrok
请求流式响应429 / 5xx → 自动切换账号重试

Capabilities · 网关能力

为 AI 编程工具调校的网关

长时间运行的 Agent 会话对连接稳定性和流式输出要求更高。2API 的调度、转发和计费都围绕这类场景设计。

原生协议,零改造

Anthropic Messages、OpenAI Responses 与 Chat Completions、Gemini v1beta 原样透传。SDK 和代码都不用换,替换 Base URL 即可。

~/.zshrc
-export ANTHROPIC_BASE_URL=https://api.anthropic.com
+export ANTHROPIC_BASE_URL=https://2api.dev
/v1/messages/v1/responses/v1/chat/completions/v1beta/models
示意

多账号调度,自动切换

上游账号组成资源池。某个账号返回 429 限流或 5xx 错误时,请求会切到下一个健康账号重试。

acc-01180ms200
acc-02204ms200
acc-03226ms200
acc-04249ms200

流式输出原样到达

SSE 事件逐条透传,思考过程、工具调用和文本增量都实时到达终端。

示意

按 Token 计费,逐笔可查

输入、输出、缓存写入和缓存读取分开统计,每次调用都记在「使用记录」里。

输入18,432
输出4,096
缓存写入12,288
缓存读取96,512
claude-sonnet-5-5 · /v1/messages--

密钥随建随用

按项目创建多个 API Key,可设置 IP 白名单和到期时间,随时停用。

  • sk-2api…3f9a个人项目
  • sk-2api…81c2CI 流水线 IP 白名单
  • sk-2api…d04e临时测试 7 天后到期

接入你常用的工具

能自定义 Base URL 的客户端,都能直接使用 2API。

CCClaude CodeCXCodex CLIGMGemini CLIGKGrok CLIOCOpenCodeCUCursorCLClineRCRoo CodeKCKilo CodeZDZed
COContinueCSCherry StudioCBChatboxLCLobeChatOWOpen WebUINCNextChatDFDifyN8n8nLGLangChain

Quickstart · 快速接入

三步开始使用

配置好之后,工具照常使用,所有请求都会经过 2API。

  1. 1注册 2API 账号
  2. 2在「API 密钥」页面创建密钥
  3. 3把下面的配置粘贴到终端
终端 · macOS / Linux
# 把 Claude Code 指向 2API
export ANTHROPIC_BASE_URL="https://2api.dev"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"

# 照常启动
claude
POST /v1/messages200 · text/event-stream
示例响应 · 仅作演示0.00s

在控制台点击密钥旁的「使用密钥」,可以直接复制已经填好地址和密钥的配置。

FAQ · 常见问题

接入前你可能想知道

没找到答案的话,登录控制台查看公告,或联系站点管理员。

2API 和直接调用官方 API 有什么区别?

2API 是一层 API 网关。请求按原生协议转发到上游,返回的格式和官方接口一致。在此之上,你还能在一处管理密钥、查看每次调用的用量。

Claude Code、Codex、Gemini CLI 要怎么配置?

注册后在「API 密钥」页面创建密钥,点击「使用密钥」就能看到各个工具的配置。以 Claude Code 为例,只需要设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 两个环境变量。

怎么计费?

按实际消耗的 Token 计费,输入、输出、缓存写入和缓存读取分开统计。每次调用的明细都能在「使用记录」里查到,具体单价以控制台显示为准。

支持流式输出和工具调用吗?

支持。请求按原生协议透传,SSE 流式输出、Tool Use / Function Calling、图片输入等能力与上游保持一致。

遇到上游限流会怎样?

网关会在多个上游账号之间调度。某个账号返回 429 或 5xx 时,请求会自动切换到其他可用账号重试,长时间运行的 Agent 任务不容易中断。

怎样保证密钥安全?

建议每个项目单独创建密钥,并按需设置 IP 白名单和到期时间。万一泄露,在控制台停用或删除对应密钥即可,不影响其他项目。

Get started · 开始使用

把 Base URL 换成 2API

注册后创建一个 API Key,Claude Code、Codex 和 Gemini CLI 马上就能用。

Claude Code export ANTHROPIC_BASE_URL=https://2api.dev