快速开始

5 分钟把网关跑通：注册 → 创建 Token → 第一次请求。

1. 服务地址

入口	地址
主入口	`https://api.geoq.help`
备用入口	`https://gateway.geoq.help`
OpenAI 兼容 base_url	`https://api.geoq.help/v1`
Anthropic 兼容 base_url	`https://api.geoq.help`
Gemini 兼容 base_url	`https://api.geoq.help`

自部署用户把上面的域名换成自己的 ZC_API_PUBLIC_URL 即可。

2. 注册账号

打开 https://api.geoq.help，点右上角注册。支持的登录方式：

用户名 + 密码
Email + 验证码
GitHub / Discord / LinuxDo / OIDC（取决于管理员是否开启）
Passkey（WebAuthn）

注册后默认是普通用户身份，进后台先看首页确认有可用模型和分组。

3. 创建 API Token

进入 令牌（Token） 页面 → 点 添加令牌：

字段	建议
名称	给这个 Token 起个能识别用途的名字，例如 `claude-code-mac`
额度	设上限，跑超就停，避免误用
过期时间	长期使用选"永不过期"，临时项目设一个具体日期
模型范围	不限制 = 当前账号能访问的全部模型
IP 限制	个人开发不用填；生产部署建议加白名单

提交后会拿到一个形如 sk-xxxxxxxx 的字符串 —— 这就是你后面所有调用的 API Key，离开页面就再也看不到，请立即保存。

4. 第一次请求

curl

bash

curl https://api.geoq.help/v1/chat/completions \
  -H "Authorization: Bearer sk-你的Token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "你好"}]
  }'

返回 200 + 一段 JSON，里面有 choices[0].message.content，就成功了。

Python（OpenAI SDK）

python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.geoq.help/v1",
    api_key="sk-你的Token",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)

Node.js（OpenAI SDK）

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.geoq.help/v1",
  apiKey: process.env.ZC_API_KEY,
});

const resp = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

5. 切换其他协议 / 模型

想用	改这两个地方
Claude	`model: "claude-sonnet-4-5"`，base_url 不变
Gemini	`model: "gemini-2.0-flash"`，base_url 不变
DeepSeek	`model: "deepseek-chat"`
阿里通义	`model: "qwen-max"`

完整模型清单在后台模型页面，或调 GET /v1/models。

6. 在编码工具里使用

继续阅读对应工具的接入指南：

常见问题

401 Unauthorized Token 拼错或带了多余空格。Authorization: Bearer sk-xxx，Bearer 和 Token 之间一个空格。

404 model not found 模型名拼错，或当前分组没绑定该模型。后台模型页面看实际可用列表。

429 Too Many Requests 触发限流。短期：等几秒重试；长期：联系管理员调高分组限流或升级套餐。

额度不足 后台首页能看到当前余额，充值或联系管理员加额度。

快速开始 ​

1. 服务地址 ​

2. 注册账号 ​

3. 创建 API Token ​

4. 第一次请求 ​

curl ​

Python（OpenAI SDK） ​

Node.js（OpenAI SDK） ​

5. 切换其他协议 / 模型 ​

6. 在编码工具里使用 ​

常见问题 ​