APIHub

教程文档

从创建 Key 到接入生产环境，通常只需要几分钟。

快速开始

我们的接口与 OpenAI 官方完全兼容。任何支持自定义 Base URL 的客户端、SDK 或工具都可以直接接入，无需额外适配。

  1. 1在控制台的「API Keys」页面创建一个 Key，创建后请立即复制保存，页面关闭后将无法再次查看完整明文。
  2. 2把你代码中的 Base URL 改为下方的中转地址。
  3. 3把原本的官方 API Key 替换为刚刚创建的 Key，其余参数保持不变。

接口地址

根据你使用的 SDK 协议选择对应的 Base URL，客户端会在其后拼接具体端点路径。两种协议可以使用同一个 API Key。

OpenAI / GPT 协议（推荐）
# Base URL
https://apihub.ltd/v1

# Chat Completions
https://apihub.ltd/v1/chat/completions

# Responses
https://apihub.ltd/v1/responses
Anthropic / Claude 协议
# Base URL
https://apihub.ltd

# Messages
https://apihub.ltd/v1/messages

OpenAI 协议的 Base URL 已含 /v1，客户端会在其后拼接 /chat/completions 或 /responses；Anthropic 协议 Base URL 为根地址，客户端会拼接 /v1/messages。若出现重复 /v1 导致 404，请据此调整 Base URL。

身份认证

所有请求都需要在 HTTP 头中携带你的 API Key。两种协议的写法如下，任选其一即可。

OpenAI
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Anthropic
x-api-key: YOUR_API_KEY
anthropic-version: 2023-06-01
Content-Type: application/json

流式输出

把请求参数中的 stream 设为 true 即可启用 SSE 流式返回，事件格式与官方完全一致，以 data: [DONE] 结束。

curl https://apihub.ltd/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "Hello!"}],
    "stream": true
  }'

# data: {"choices":[{"delta":{"content":"He"}}]}
# data: {"choices":[{"delta":{"content":"llo"}}]}
# data: [DONE]

错误码

错误响应结构与官方保持一致，可直接沿用你现有的错误处理逻辑。

状态码含义处理建议
401API Key 无效、已被禁用或已过期检查 Key 是否填写完整，或在控制台确认其状态。
402账户余额不足前往控制台充值，或检查该 Key 是否已达到自定义额度上限。
403该 Key 无权访问所请求的模型检查 Key 的模型白名单设置。
404模型不存在或未启用对照模型价格页确认 model 参数拼写是否正确。
429触发速率限制降低并发或请求频率，建议实现指数退避重试。
500 / 502上游服务异常通常会自动切换线路，若持续出现请联系技术支持。

第三方客户端接入

以下常用工具均可直接接入，只需在设置中填写自定义 Base URL 与 API Key。

  • Cherry Studio、ChatBox、LobeChat 等桌面/网页客户端
  • Cursor、Continue、Cline 等编程助手
  • Dify、n8n、FastGPT 等工作流与知识库平台
  • 任何基于 OpenAI 官方 SDK 构建的自研应用

没有找到需要的内容？

联系技术支持