HakanAI 文档 | 协议兼容矩阵

各模型对 Chat / Responses / Anthropic / Gemini 等协议的支持情况一览

Hakan AI 内部会把不同协议的请求转换到对应的上游通道，因此同一个模型往往可以走多种协议（例如用 Anthropic SDK 调 GPT、用 OpenAI SDK 调 Claude）。但也有协议限制：/v1/responses 只对 OpenAI 系列稳定可用；部分模型仅在特定端点上开放。

本页给出各模型对四种主流协议的支持情况，方便你在配置 SDK / CLI 客户端（如 Codex、Cursor、Continue 等）时快速选择。

四种协议 · 一图看懂用哪个

端点	需要 SDK / 客户端	请求特征
`POST /v1/chat/completions`	OpenAI SDK 或任何 OpenAI 兼容客户端	`messages` + `max_tokens`
`POST /v1/responses`	OpenAI Codex CLI、部分需要"推理接口"的客户端	`input` + `max_output_tokens`
`POST /v1/messages`	Anthropic SDK	`x-api-key` 头 + `anthropic-version`
`POST /v1beta/models/{model}:generateContent`	Google Gemini SDK	`x-goog-api-key` 头

聊天模型 · 协议支持矩阵

图例：✅ 稳定可用 · ❌ 不支持 / 上游拒绝 · ⚠️ 偶尔抖动

OpenAI GPT 系列 — 四种协议全支持

模型	Chat	Responses	Anthropic	Gemini
`gpt-4.1`	✅	✅	✅	✅
`gpt-5`	✅	✅	✅	✅
`gpt-5-mini`	✅	✅	✅	✅
`gpt-5-nano`	✅	✅	✅	✅
`gpt-5.4`	✅	✅	✅	✅
`gpt-5.4-mini`	✅	✅	✅	✅
`gpt-5.4-nano`	✅	✅	✅	✅
`gpt-5.5`	✅	✅	✅	✅

推荐：需要走 Codex CLI（wire_api = "responses"）时首选 GPT 系列，唯一稳定支持 Responses 接口的家族。

Claude 系列 — 三种协议支持，不走 Responses

模型	Chat	Responses	Anthropic	Gemini
`claude-haiku-4-5-20251001`	✅	❌	✅	✅
`claude-sonnet-4-6`	✅	❌	✅	✅
`claude-opus-4-6`	✅	❌	✅	✅
`claude-opus-4-7`	✅	❌	✅	✅
`claude-opus-4-8`	✅	❌	✅	✅

推荐：Anthropic SDK 直接调（原生功能最完整，含扩展思考 thinking），或者用 OpenAI SDK 走 Chat 兼容。

Gemini 文本系列 — 三种协议支持，不走 Responses

模型	Chat	Responses	Anthropic	Gemini
`gemini-2.0-flash`	✅	❌	✅	✅
`gemini-2.5-flash`	✅	❌	✅	✅
`gemini-2.5-flash-lite`	✅	❌	✅	✅
`gemini-2.5-pro`	✅	❌	✅	✅
`gemini-3-flash-preview`	✅	❌	✅	✅
`gemini-3-pro-preview`	✅	❌	✅	✅
`gemini-3.1-pro-preview`	✅	❌	✅	✅
`gemini-3.5-flash`	✅	❌	✅	✅

推荐：Google Gemini SDK 直接调，或用 OpenAI SDK 走 Chat 兼容。

其它聊天模型

模型	Chat	Responses	Anthropic	Gemini
`deepseek-chat`	✅	⚠️	✅	✅
`deepseek-reasoner`	✅	⚠️	✅	✅
`deepseek-v4-flash`	✅	⚠️	✅	✅
`deepseek-v4-pro`	✅	⚠️	✅	✅
`glm-5`	✅	⚠️	✅	✅
`glm-5.1`	✅	✅	✅	✅
`glm-5.2`	✅	⚠️	✅	✅
`kimi-k2.6`	✅	✅	✅	✅
`qwen3.5-plus`	✅	❌	✅	✅
`qwen3.6-plus`	✅	✅	✅	✅
`minimax-2.7`	✅	✅	✅	✅
`waifubot-chat`	✅	❌	✅	✅
`waifubot-chat-pro`	✅	❌	✅	✅

推荐：所有非 OpenAI 系列都建议用 wire_api = "chat"，兼容性最好。

图像生成模型

统一走 POST /v1/images/generations（OpenAI 兼容），详见图像生成接口。

模型	状态
`gpt-image-2`	✅
`seedream-4.6`	✅
`seedream-5`	✅
`gemini-2.5-flash-image`	✅
`gemini-3-pro-image-preview`	✅
`gemini-3.1-flash-image-preview`	✅
`nano-banana-1` `nano-banana-2` `nano-banana-pro`	⚠️ 上游通道不稳定
`seedream-4.5`	⚠️ 上游通道不稳定

嵌入 / 重排 / 视觉

模型	端点	状态
`text-embedding-3-small`	`POST /v1/embeddings`	✅
`text-embedding-3-large`	`POST /v1/embeddings`	✅
`bge-reranker-v2-m3`	`POST /v1/rerank`	✅
`waifubot-view`	`POST /v1/chat/completions`（视觉模型走 chat）	✅

当前不可用的模型（上游通道异常）

以下模型在数据库里已上架但上游通道当前 503，尝试所有协议均失败。等待上游或运维恢复：

gpt-5.3-codex
grok-4 / grok-4-mini / grok-4.1#search / grok-4.1-fast / grok-4.20-fast（Grok 全家目前不可用）
waifubot-chat-fast
waifubot-search
suno-v4.5

常见客户端配置建议

Codex CLI（`wire_api = "responses"`）

只能用 GPT 系列（其它模型 Responses 端点都 503）：

model = "gpt-5.5"                # 或 gpt-5.4 / gpt-5.4-mini / gpt-4.1 / gpt-5-mini
model_provider = "HakanAI"

[model_providers.HakanAI]
base_url = "https://hakanaiktn.com/v1"
name = "HakanAI"
requires_openai_auth = true
wire_api = "responses"

想用 Claude / Gemini 时把 wire_api 改为 "chat"：

model = "gemini-3.1-pro-preview"   # 或 claude-sonnet-4-6 / 任意聊天模型
model_provider = "HakanAI"

[model_providers.HakanAI]
base_url = "https://hakanaiktn.com/v1"
name = "HakanAI"
requires_openai_auth = true
wire_api = "chat"                  # ← 关键

Cursor / Cline / Continue / LangChain（OpenAI Chat）

用 POST /v1/chat/completions（base_url = https://hakanaiktn.com/v1），任何聊天模型都可以。

Anthropic SDK 原生

用 POST /v1/messages（base_url = https://hakanaiktn.com，不带 /v1），可以直接调 GPT / Claude / Gemini / DeepSeek 等大部分聊天模型。

Google Gemini SDK

用 POST /v1beta/models/{model}:generateContent（base_url = https://hakanaiktn.com），同样可以调 GPT / Claude / Gemini 等。

协议兼容矩阵