🚀 快速开始

三步即可接入：

支持协议

模型列表

以下为当前可用模型，详细价格见「价格」页。

Claude 系列 Anthropic 协议

GPT 系列 OpenAI 协议

GLM 系列 OpenAI 协议

图片生成 按次计费

价格

所有模型按 原价 × 1.5 计费，单位 ¥/1M Tokens（图片按次）。

Claude 系列

GPT 系列

GLM 系列

CC Switch 一键配置

CC Switch 是统一的 API 切换工具，可一键把 Claude Code / Codex 切到二哈 API。

步骤

{
  "name": "二哈 API",
  "base_url": "https://api.erhaa.com",
  "key": "sk-你的key",
  "model": "claude-opus-4-8"
}

切换模型

在 CC Switch 里切换不同 Provider 即可切换模型，无需手动改配置。

Claude Code 手动配置

设置环境变量即可让 Claude Code 走二哈 API。

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://api.erhaa.com","User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","sk-你的key","User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL","claude-opus-4-8","User")

export ANTHROPIC_BASE_URL=https://api.erhaa.com
export ANTHROPIC_AUTH_TOKEN=sk-你的key
export ANTHROPIC_MODEL=claude-opus-4-8

source ~/.zshrc

验证

claude

启动后状态栏显示模型即配置成功。模型可换 claude-sonnet-4-6（便宜）或 claude-opus-4-8（旗舰）。

Codex 手动配置

Codex 走 OpenAI 协议。

环境变量

OPENAI_BASE_URL=https://api.erhaa.com/v1
OPENAI_API_KEY=sk-你的key

或配置文件 ~/.codex/config.toml

[model_providers.erha]
name = "二哈 API"
base_url = "https://api.erhaa.com/v1"
env_key = "OPENAI_API_KEY"

[model]
name = "gpt-5.5"
provider = "erha"

模型可选 gpt-5.5、gpt-5.4、gpt-5.3-codex（代码专用）。

Cherry Studio 配置

1. 打开 Cherry Studio → 设置 → 模型服务 → 添加「自定义」。
2. API 地址填 https://api.erhaa.com，API Key 填 sk-你的key。
3. 模型名手动添加：gpt-5.5、claude-opus-4-8、glm-5.2 等。
4. 保存后即可在对话里选择模型使用。

Claude Desktop 配置

Claude Desktop 只接受 https 网关 + 只认 claude 模型名，二哈 API 已满足。

1. 启动 Claude Desktop，左上角菜单 → Help → Troubleshooting → Enable Developer mode。
2. 顶部 Developer → Configure third-party inference。
3. 填入：

   字段	值
   Connection	Gateway
   Gateway base URL	https://api.erhaa.com
   Gateway API key	sk-你的key
   模型	claude-opus-4-8

4. 保存后新建对话选 claude-opus-4-8 即可。

API 调用示例

curl https://api.erhaa.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role":"user","content":"你好，二哈！"}]
  }'

curl https://api.erhaa.com/v1/messages \
  -H "Authorization: Bearer sk-你的key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4-8",
    "max_tokens": 1024,
    "messages": [{"role":"user","content":"你好"}]
  }'

from anthropic import Anthropic
client = Anthropic(base_url="https://api.erhaa.com", api_key="sk-你的key")
msg = client.messages.create(
    model="claude-opus-4-8", max_tokens=1024,
    messages=[{"role":"user","content":"你好"}])
print(msg.content[0].text)

from openai import OpenAI
client = OpenAI(base_url="https://api.erhaa.com/v1", api_key="sk-你的key")
r = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role":"user","content":"你好"}])
print(r.choices[0].message.content)

import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({ baseURL:"https://api.erhaa.com", apiKey:process.env.KEY });
const m = await client.messages.create({
  model:"claude-opus-4-8", max_tokens:1024,
  messages:[{role:"user",content:"你好"}]});

图片生成

curl https://api.erhaa.com/v1/images/generations \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"一只二哈","n":1}'

常见问题

请求返回 401？

检查 API Key 是否正确、是否已禁用或过期。在控制台「API Key」页重新生成。

请求返回 503 无可用渠道？

该模型对应渠道此刻不可用（公益站高峰期常见）。稍后重试，或换其他模型。

Claude Desktop 提示「非法模型」？

Desktop 只认 claude 模型名，填 claude-opus-4-8，不要填 glm/gpt。

余额怎么算？

1 元 = 1 额度（汇率 1:1）。按 token 消耗计费，价格 = 原价 × 1.5。图片按次。

支持流式吗？

支持，请求加 "stream": true。

模型映射是什么？

部分 claude 模型名会映射到实际后端模型（如 claude-opus-4-8 可能走 glm-5.2）。响应里 model 字段是实际后端模型名，属正常。