HakanAI 文档 | API 接口概述

Hakan AI 提供与 OpenAI API 完全兼容的接口服务，同时支持 Anthropic 和 Gemini 等多种原生协议。

接口端点

OpenAI 端点

端点类型	地址	说明
Chat Completions	`https://hakanaiktn.com/v1/chat/completions`	聊天补全接口，适用于大多数模型
Responses	`https://hakanaiktn.com/v1/responses`	Response 接口，部分推理模型必须使用
标准端点	`https://hakanaiktn.com/v1`	SDK 推荐用于 `base_url`
基础端点	`https://hakanaiktn.com`	部分应用 / Anthropic SDK 使用

重要提示：o3-pro、gpt-5.x-pro 等部分推理模型仅支持 Response 接口。

其他协议端点

协议	端点地址	说明
Anthropic 原生协议	`https://hakanaiktn.com/v1/messages`	Claude 原生协议，支持完整功能
Gemini 原生协议	`https://hakanaiktn.com/v1beta`	Gemini 原生协议

认证方式

所有 API 请求都需要通过 API 令牌进行身份验证。在令牌管理创建和管理令牌。

OpenAI / 大多数协议

使用 Authorization 请求头：

Authorization: Bearer sk-xxxxxxxxxxxxxxxx

Anthropic 原生协议

使用 x-api-key 请求头，并同时携带 anthropic-version：

x-api-key: sk-xxxxxxxxxxxxxxxx
anthropic-version: 2023-06-01

Gemini 原生协议

使用 x-goog-api-key 请求头：

x-goog-api-key: sk-xxxxxxxxxxxxxxxx

完整请求示例

curl https://hakanaiktn.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxx" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "你好！"}]
  }'

请求格式

所有 API 请求使用 JSON 格式，Content-Type 为 application/json，方法均为 POST。

基础请求结构（OpenAI 协议）

{
  "model": "模型名称",
  "messages": [
    {"role": "system", "content": "系统提示词"},
    {"role": "user", "content": "用户消息"}
  ],
  "temperature": 0.7,
  "max_tokens": 2048,
  "stream": false
}

常用参数

参数	类型	必填	说明
`model`	string	✅	模型名称，例如 `gpt-4o`、`claude-sonnet-4-5-20250929`
`messages`	array	✅	消息列表，包含角色与内容
`temperature`	number		随机性，`0-2` 之间，默认 1
`max_tokens`	integer		最大输出 token 数
`stream`	boolean		是否启用流式输出，默认 `false`
`top_p`	number		核采样参数，`0-1` 之间
`presence_penalty`	number		出现惩罚，`-2.0` 到 `2.0`
`frequency_penalty`	number		频率惩罚，`-2.0` 到 `2.0`
`tools`	array		函数 / 工具调用列表
`response_format`	object		强制响应格式（如 `json_object`）

完整字段请参考 OpenAI 官方文档，几乎所有字段均已透传。

响应格式

标准响应

{
  "id": "chatcmpl-xxxxxxxx",
  "object": "chat.completion",
  "created": 1234567890,
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好！有什么可以帮你的吗？"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 15,
    "total_tokens": 25
  }
}

流式响应

启用 stream: true 后，响应以 Server-Sent Events（SSE）格式返回：

data: {"id":"chatcmpl-xxx","choices":[{"delta":{"content":"你"},"index":0}]}

data: {"id":"chatcmpl-xxx","choices":[{"delta":{"content":"好"},"index":0}]}

data: [DONE]

每条 data: 行都是一个 JSON 片段，最后一行 data: [DONE] 标识流结束。

错误码

HTTP 状态码	错误类型	说明
400	Bad Request	请求参数错误，检查 JSON 字段
401	Unauthorized	令牌无效、未提供或被禁用
403	Forbidden	无权访问该模型 / 资源
404	Not Found	接口路径或模型不存在
429	Too Many Requests	请求频率超限，参考服务等级与限速
500	Internal Server Error	服务端内部错误，可重试
503	Service Unavailable	上游 / 服务暂时不可用

错误响应示例

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

全模型聚合

通过标准的 /v1/chat/completions 接口，可以统一访问 所有支持的聊天模型，包括 GPT、Claude、Gemini、DeepSeek、Qwen 等。Hakan AI 在后端自动完成协议兼容与字段转换。

也就是说，只需更换 model 字段，无需切换 SDK，即可使用不同厂商的模型。

接口限制

请求频率：根据令牌类型与账户等级而异，参考服务等级与限速
单次请求超时：普通请求约 5 分钟，Response 接口（推理模型）可达 20 分钟
单次最大上下文：取决于具体模型的上下文窗口（如 GPT-4o 为 128K，Claude Sonnet 为 200K）

API 接口概述

On this page