跳转到主要内容

​
开始前

你需要一个 AIOHub 账号和可用余额。首次接入建议先用 OpenAI Chat Completions 完成验证，再按客户端切换到 OpenAI Responses、Claude Messages 或 Gemini API 格式。

​
四步发出第一次请求

1

注册并进入控制台

访问 AIOHub 控制台 注册账号。登录后在 钱包管理 确认账户已有可用额度；需要充值时参考 充值说明。
2

创建 API 令牌

打开 API 令牌管理，创建一个 sk- 开头的 API 令牌。为每个工具创建独立 API 令牌，便于按客户端查看用量日志并设置额度限制。
API 令牌是敏感调用凭证。不要发送给他人，也不要提交到 Git 仓库。
3

确认可用模型

先请求模型列表，确认 API 令牌、余额和分组配置可用。
curl https://api.aiohub.org/v1/models \
  -H "Authorization: Bearer sk-你的API令牌"
成功响应会返回当前 API 令牌的分组可访问的模型列表。
4

发送对话请求

使用 OpenAI Chat Completions 发送第一条对话请求。
curl https://api.aiohub.org/v1/chat/completions \
  -H "Authorization: Bearer sk-你的API令牌" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

​
选择 API 格式

场景Base URL请求路径
OpenAI SDK / 通用工具https://api.aiohub.org/v1POST /chat/completions
Codex CLIhttps://api.aiohub.org/v1POST /responses
Anthropic SDK / Claude Codehttps://api.aiohub.orgPOST /v1/messages
Gemini CLIhttps://api.aiohub.orgPOST /v1beta/models/{model}:generateContent
Gemini REST / Google SDKhttps://api.aiohub.org/v1betaPOST /models/{model}:generateContent
不确定客户端需要哪个格式时，先查看对应的客户端指南；只写 API 代码时优先使用 OpenAI Chat Completions。

​
下一步

选择客户端

将 AIOHub 接入 Claude Code、Codex CLI、Gemini CLI 或聊天客户端。

了解分组

确认你的 API 令牌所属分组能访问目标模型。

查看 API 文档

查看鉴权方式、端点列表和 API Playground。

排查错误

处理鉴权失败、余额不足、网络连接和模型不可用。