QIGLOW / DOCS

接入文档

从第一条请求开始。这里提供接口地址、客户端配置与排错说明。

01快速开始

注册并准备额度。前往注册页面创建账户，在控制台查看余额并按需充值。
创建 API Key。进入密钥管理创建密钥；不要把密钥发给他人、写入前端代码或提交到代码仓库。
发送请求。在自己的终端设置环境变量，然后运行下方 cURL。请求会使用账户额度。

密钥只留在你自己的环境里。本页没有密钥输入框，也不会发送模型请求。以下终端示例使用 Bash；请勿直接粘贴到 PowerShell。

API Origin / Base URL: https://api.qgapi.top
生成消息: POST /v1/messages
模型列表: GET /v1/models
认证与版本: x-api-key · anthropic-version: 2023-06-01

Base URL 不带 /v1 或 /messages；完整请求地址才包含接口路径。

Bash · 仅在自己的终端输入密钥

read -r -s -p "栖光 API Key: " ANTHROPIC_API_KEY
export ANTHROPIC_API_KEY
printf '\n'
export ANTHROPIC_BASE_URL="https://api.qgapi.top"

cURL · 最小 Messages 请求

curl -sS -w '\nHTTP %{http_code}\n' \
  https://api.qgapi.top/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-haiku-5-5",
    "max_tokens": 32,
    "messages": [{"role": "user", "content": "你好，请简短回复。"}]
  }'

成功时可在 JSON 的 content 数组中查看回复，usage 中查看用量；遇到非成功状态码，先保留响应体，再按错误排查表处理。示例不预设具体回复或费用。

选择模型

使用完整 ID，不自行缩写或添加版本后缀。当前接入文档列出以下五个 ID；账户可见范围请结合模型列表响应确认，价格见公开模型广场。

claude-opus-5-5
claude-sonnet-5-5
claude-haiku-5-5
claude-fable-5
claude-fable-5-1

cURL · 查询可见模型

curl -sS -w '\nHTTP %{http_code}\n' \
  https://api.qgapi.top/v1/models \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01"

02客户端配置

Python · 官方 Anthropic SDK

设置好密钥后，安装官方 Anthropic SDK。

终端 · 安装官方 Python SDK

python -m pip install anthropic

Python · 保存为 quickstart.py

import os
from anthropic import Anthropic

client = Anthropic(
    api_key=os.environ["ANTHROPIC_API_KEY"],
    base_url="https://api.qgapi.top",
    default_headers={"anthropic-version": "2023-06-01"},
)

message = client.messages.create(
    model="claude-haiku-5-5",
    max_tokens=32,
    messages=[{"role": "user", "content": "你好，请简短回复。"}],
)
for block in message.content:
    if block.type == "text":
        print(block.text)

将示例保存为 quickstart.py，在同一终端运行 python quickstart.py。请勿将真实密钥替换进源代码。

Claude Code · 第三方网关

适用于已安装的 Claude Code CLI；安装方式见官方安装文档。先执行快速开始中的密钥设置，再在同一 Bash 终端运行：

Bash · 在已设置密钥的同一终端执行

unset ANTHROPIC_AUTH_TOKEN
export ANTHROPIC_BASE_URL="https://api.qgapi.top"
export ANTHROPIC_MODEL="claude-sonnet-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5"
claude

ANTHROPIC_API_KEY 对应本站使用的 x-api-key；ANTHROPIC_AUTH_TOKEN 对应 Bearer 认证，因此此例在当前终端清除该变量，避免混用。配置方式见官方网关连接说明；模型变量见官方模型配置。

启动后用 /status 检查 Base URL 与认证来源。环境变量只对当前终端及其启动的程序生效；桌面图标启动的程序不一定继承。若已有自定义认证或模型配置，请先检查冲突，不要盲目覆盖。

若 Claude Code 提示不支持模型，先按官方说明更新客户端，再重试。

03计费说明

人民币充值 1∶1 到账：¥1 = 1 站内额度，界面记作 $1。

官方参考价使用美元；本站实付列数值按标准充值对应人民币基础成本，$ 是记账样式。倍率不是同币种溢价。

当前单价见模型广场，实际用量见控制台。

04常见问题

请求失败，先看什么？

同时查看 HTTP 状态码和响应体的错误信息。状态码只是排查入口，不代表唯一原因；不要对所有错误反复重试。

状态	优先检查	处理方式
401	密钥或认证头	检查密钥是否有效、环境变量是否传入、是否使用 `x-api-key`。修正认证后再请求。
403	余额、分组或访问权限	按响应体核对账户余额、密钥额度与模型权限；不要仅凭状态码就充值或换密钥。
404	路径或模型白名单	核对 `/v1/messages` 与完整模型 ID；检查是否重复拼接 `/v1`，并查询模型列表。
429	并发、频率或上游限制	减少并发；若有 `Retry-After`，按其提示等待。确认属于暂时限流后再退避重试，持续受限请联系支持。
5xx	网关或上游服务问题	保留发生时间、请求 ID 与响应体。先确认是否已收到输出，再决定是否有限重试；持续失败请联系支持。
400 / 其他	参数与响应体提示	检查 JSON、`model`、`max_tokens` 和 `messages`；据具体错误修正，不要直接归因于服务故障。

Base URL 应该填写哪个地址？

本文的 Python SDK 与 Claude Code 使用 https://api.qgapi.top。cURL 使用完整地址 https://api.qgapi.top/v1/messages。官网和文档域名不是 API 地址。

为什么 curl 可以用，客户端却失败？

检查客户端实际使用的 URL、认证来源与模型 ID；确认它从设置了环境变量的终端启动。Claude Code 可用 /status 排查。其他客户端请确认最终请求地址为 https://api.qgapi.top/v1/messages。

密钥泄露了怎么办？

到密钥管理停用或删除泄露的密钥，再创建新密钥并更新本地配置。检查用量记录；截图、日志和工单中请遮盖密钥。

怎样联系支持？

可联系 support@qgapi.top。请提供发生时间（含时区）、模型 ID、HTTP 状态码、请求 ID（如有）及脱敏后的响应体；不要发送完整 API Key 或敏感提示内容。