ApiHub API 接入文档
兼容 OpenAI 标准接口,复制 Base URL 与 API Key 即可接入。支持的模型 ID 与计价见 模型广场。
1. 基础信息
- Base URL:
https://video.gqaiapp.com/v1(推荐填写 /v1;接口路径与 OpenAI 标准接口的 /v1/chat/completions 习惯一致) - API Key: 在控制台 开通并复制(格式
sk-...) - 鉴权(二选一):
Authorization: Bearer YOUR_API_KEY或X-API-Key: YOUR_API_KEY - 计费单位: CNY,按 Token 扣减余额,余额不足返回 HTTP 402
2. 兼容接口
支持 OpenAI 标准接口(Chat Completions / Responses)。路径相对 Base URL。
Chat Completions
POST /chat/completionsResponses
POST /responses模型列表
GET /modelsAnthropic Messages / Claude Code
POST /messagesMax20x: 请使用官方 Claude Code 客户端和绑定 Max20x 通道的 API Key。本服务会原生透传 Messages 流式协议,不会转换为 Chat Completions。
Stream 说明: Chat/Responses 兼容入口会按通道能力处理流式响应;Max20x 的 Messages 入口保持原生真流式转发,无需修改 Claude Code 配置。
3. cURL 示例
curl https://video.gqaiapp.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"messages": [
{"role": "user", "content": "Hello ApiHub"}
]
}'4. Python SDK 示例
from openai import OpenAI
client = OpenAI(
base_url="https://video.gqaiapp.com/v1",
api_key="YOUR_API_KEY",
)
response = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[{"role": "user", "content": "Hello ApiHub"}],
)
print(response.choices[0].message.content)5. Node.js / TypeScript SDK 示例
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://video.gqaiapp.com/v1",
apiKey: "YOUR_API_KEY",
});
const response = await client.chat.completions.create({
model: "claude-sonnet-4-6",
messages: [{ role: "user", content: "Hello ApiHub" }],
});
console.log(response.choices[0].message.content);6. Responses API 示例
curl https://video.gqaiapp.com/v1/responses \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4-pro",
"input": "Write a short follow-up email to a new lead"
}'7. 客户端工具配置(ApiHub / Cherry Studio / NextChat 等)
BASE_URL = https://video.gqaiapp.com/v1 API_KEY = YOUR_API_KEY
填入 Base URL 与 API Key 后,模型列表会自动拉取。无需额外配置 stream 选项。
8. Claude Code / Max20x 配置
ANTHROPIC_BASE_URL=https://video.gqaiapp.com ANTHROPIC_AUTH_TOKEN=YOUR_MAX20X_CHANNEL_API_KEY claude --model claude-sonnet-4-6
API Key 必须绑定 Claude Max20x 通道;Fable 5 请改用绑定 AIVaLux Kiro 通道的 Key。
9. 错误码说明
| HTTP 状态码 | 含义 | 处理建议 |
|---|---|---|
401 | API Key 缺失或无效 | 检查 Authorization 头或 X-API-Key 是否正确 |
402 | 余额不足 | 前往控制台充值后重试 |
403 | 账户已停用 | 联系客服 |
429 | 请求过于频繁 | 降低并发或稍后重试 |
500 | 服务暂时不可用 | 稍后重试;持续报错请联系客服 |