HohoAI 接入文档
一个 API Key,统一调用 Claude 与 GPT 全系模型。真模型,不降智,专为 Coding 优化。
简介
HohoAI 是面向开发者的 AI 模型网关,提供 Anthropic Claude 与 OpenAI GPT 全系模型的稳定接入。你可以用同一个 Key、同一个域名,在 Claude Code、Codex、Cursor、Cline 等工具里调用任意模型。
- 真模型,不降智 —— 原生协议透传、多渠道择优,请求即返回,绝不偷换模型。
- 双协议兼容 —— 同时支持 Anthropic
/v1/messages与 OpenAI/v1/chat/completions//v1/responses。 - 按量透明计费 —— 用多少扣多少,prompt 缓存最高省 70%。
快速开始
- 在 控制台 注册账号(注册送体验额度)。
- 充值:支持 支付宝 / 微信 / 信用卡。
- 进入 令牌管理,新建一个令牌,复制
sk-...Key。 - 在你的客户端里把 base_url 指向 HohoAI、填入 Key(见下方各客户端)。
接口地址
| 协议 | Base URL | 用途 |
|---|---|---|
| Anthropic | https://api.hohocode.ai | Claude Code、Claude 系模型 |
| OpenAI | https://api.hohocode.ai/v1 | Codex、Cursor、GPT 系模型 |
认证:Anthropic 协议用
x-api-key 或 ANTHROPIC_AUTH_TOKEN;OpenAI 协议用 Authorization: Bearer sk-...。Claude Code 推荐
设置两个环境变量即可,无需改任何代码:
# 写进 ~/.claude/settings.json 的 env 亦可 export ANTHROPIC_BASE_URL="https://api.hohocode.ai" export ANTHROPIC_AUTH_TOKEN="sk-你的key" unset ANTHROPIC_API_KEY # 避免与官方 key 冲突 claude
之后正常使用 Claude Code,模型走 claude-opus-4-8 / claude-sonnet-4-6 等。
Codex
编辑 ~/.codex/config.toml:
model = "gpt-5.5" # 也可 gpt-5 / gpt-4o / o3 等 model_provider = "hohoai" [model_providers.hohoai] name = "HohoAI" base_url = "https://api.hohocode.ai/v1" env_key = "HOHOAI_API_KEY" wire_api = "responses"
export HOHOAI_API_KEY="sk-你的key"
codex
注意:Codex 新版要求
wire_api = "responses"(旧版的 "chat" 已不支持)。模型建议用 gpt-5.5(最新最强的 agentic coding 模型)。Cursor
Cursor → Settings → Models → OpenAI API Key:
- Override Base URL 填:
https://api.hohocode.ai/v1 - API Key 填你的
sk-... - 勾选要使用的模型(如
gpt-5.5、gpt-4o)
Cursor 的部分原生功能(Tab 补全、Agent 索引)走 Cursor 自有服务,Override Base URL 主要影响 Chat 调用。
Cline
Cline → API Provider:
- 选 Anthropic(用 Claude):Base URL
https://api.hohocode.ai - 或选 OpenAI Compatible(用 GPT):Base URL
https://api.hohocode.ai/v1 - API Key 填
sk-...,Model 填claude-sonnet-4-6或gpt-5.5等
cURL / SDK
Claude(Anthropic 格式)
curl https://api.hohocode.ai/v1/messages \ -H "x-api-key: sk-你的key" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{"model":"claude-sonnet-4-6","max_tokens":1024, "messages":[{"role":"user","content":"写个快排"}]}'
GPT(OpenAI 格式)
curl https://api.hohocode.ai/v1/chat/completions \ -H "Authorization: Bearer sk-你的key" \ -H "content-type: application/json" \ -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"写个快排"}]}'
官方 SDK 也可直接用,只需把 base_url / api_key 换成 HohoAI 的:
# Python (openai SDK) from openai import OpenAI client = OpenAI( base_url="https://api.hohocode.ai/v1", api_key="sk-你的key", ) r = client.chat.completions.create( model="gpt-5.5", messages=[{"role":"user","content":"hi"}], )
模型列表
以下为当前在售模型,完整列表与实时价格见 控制台 · 模型广场。
Claude(Anthropic)
| 模型 ID | 说明 |
|---|---|
claude-opus-4-8 | 旗舰,复杂推理与长程 agentic coding 天花板 |
claude-sonnet-4-6 | 速度与智能的最佳平衡,日常主力 |
claude-sonnet-5 | 新一代高性能,复杂推理与编码 |
GPT / o 系(OpenAI)
| 模型 ID | 说明 |
|---|---|
gpt-5.5 | 最新旗舰,最强 agentic coding |
gpt-5.4 / gpt-5.4-mini | GPT-5 系列(平价编码) |
gpt-5-mini | 平价快速 |
gpt-4.1 / gpt-4.1-mini | GPT-4.1 系列 |
gpt-4o / gpt-4o-mini | 经典多模态 |
o3 / o3-mini / o4-mini / o1 | 推理模型(o 系) |
计费说明
- 预付费制:充值得额度,按 token 实时扣费。余额不足时调用暂停,充值即恢复。
- 计费方式:按实际 token 用量实时扣费,每个模型有明确的输入/输出单价(人民币),具体见首页「模型单价查询」。
- 分组:普通组与 VIP 组单价不同,VIP 单价更低;量大可联系升级 VIP。
- Prompt 缓存:命中缓存的部分仅按 1 折计费,Coding 重复上下文场景可省 50–70%。
- 每一笔调用的输入/输出/缓存/扣费明细,均可在控制台「使用日志」查看。
常见问题
需要科学上网或海外信用卡吗?
都不需要。人民币直充,国内网络直连 api.hohocode.ai,一行配置即可用。
会降智或偷换模型吗?
不会。原生协议透传、多渠道择优,请求什么模型返回什么模型,可自测验真。
调用报"额度不足"怎么办?
账户余额已用尽,前往控制台充值即可恢复。
Codex 报 wire_api "chat" is no longer supported?
把 config.toml 里的 wire_api 改为 "responses" 即可(见上方 Codex 章节)。
支持哪些客户端?
Claude Code、Codex、Cursor、Cline、Roo Code、Aider、Continue 等,凡是能改 base_url 的都支持。
© 2026 HohoAI · hohocode.ai