本域名(aiapi.gzisp.net)是 AI Token 的专用开放接口。接口地址:https://aiapi.gzisp.net/v1/chat/completions;当前已由管理员关闭,暂不可调用。
403 api_global_disabled(密钥正确也一样;你的 Token 余额、密钥与配额都会被保留,开放后原样可用)。
本页仅作接入说明保留,请等平台开放后再联调。
我们按产品类型拆分了对外 API 域名:
aiapi.gzisp.net:AI Token 开放接口(本文档,OpenAI 兼容对话补全)。wapi.gzisp.net:域名、网站基础类产品 API。若你要调用域名 / 主机 / 建站等能力,请前往 wapi.gzisp.net。所有请求需在请求头携带会员专属 API Key(在会员中心 /member/apikeys 生成,支持多把、可独立吊销、可限定有效期与可用模型):
# 方式一:Authorization 头(推荐) Authorization: Bearer sk-你的密钥 # 方式二:X-Api-Key 头(便于部分 SDK / 代理) X-Api-Key: sk-你的密钥 # 方式三:查询参数(仅调试用) ?api_key=sk-你的密钥
密钥明文仅在生成时显示一次,请妥善保存。泄露后可随时在会员中心吊销,对应 Agent 立即失效。
OpenAI 兼容的请求 / 响应结构,可直接使用 OpenAI SDK、LangChain 等生态工具,把 base_url 指向本接口域名即可。
| 项 | 说明 |
|---|---|
| 方法 / 路径 | POST https://aiapi.gzisp.net/v1/chat/completions |
| 请求体 | OpenAI 格式:model、messages、可选 stream / max_tokens / temperature |
| 计费 | 按 Token 实时计量,从会员 AI 账户余额扣减。调用上游之前先做余额预检(预估 = 提示词 token + max_tokens,fail-closed),余额不足直接返回 insufficient_quota,此时代码不会去调用任何上游模型、不产生任何费用 |
| 结算不足 | 极端情形(模型未遵守 max_tokens,实际消耗超过预检):上游已完成、费用已发生,平台会如实记账并挂账,返回 402 settle_shortfall —— 它不是「未执行」,不可当作可免费重试的失败 |
| 模型范围 | 仅限该会员已被授权开通的模型;每把密钥还可进一步按模型白名单收窄(防止误调高价模型) |
示例(curl)
curl https://aiapi.gzisp.net/v1/chat/completions \
-H "Authorization: Bearer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-4o",
"messages": [{"role":"user","content":"你好,介绍一下你自己"}],
"max_tokens": 512
}'
示例(Python · OpenAI SDK)
# pip install openai from openai import OpenAI client = OpenAI( api_key="sk-你的密钥", base_url="https://aiapi.gzisp.net/v1" # 注意:base_url 指向本域名,路径自动拼 /chat/completions ) r = client.chat.completions.create( model="gpt-4o", messages=[{"role":"user","content":"你好"}], max_tokens=512, ) print(r.choices[0].message.content)
成功返回标准 OpenAI chat.completion 对象(含 usage);错误返回 OpenAI 兼容 error 结构。
| HTTP | code | 含义 |
|---|---|---|
| 401 | invalid_api_key | 缺少或无效的 API Key |
| 400 | invalid_request_error | 请求体缺 model / messages 等参数问题 |
| 400 | invalid_model · invalid_messages · invalid_provider_id | 参数级失败(网关返回的细分码,message 里有说明) |
| 400 | insufficient_quota | Token 余额不足:低估不了,平台在调用上游之前就已拦截,本次未调用任何模型、未产生任何费用。充值后重试即可 |
| 402 | settle_shortfall | 已调用、但结算不足:上游已完成、费用已发生,差额已挂账。不可当作「未执行」,请充值后继续 |
| 503 | balance_check_failed | 余额校验本身失败(读取异常)。按 fail-closed 处理:不调用上游、不产生费用,稍后用同一请求重试即可 |
| 502 | upstream_failed | 上游厂商调用失败(网络 / 鉴权 / 限流等)。平台侧未扣费,可重试 |
| 403 | channel_disabled · channel_not_authorized · channel_not_granted | 渠道已停用 / 未通过平台合规授权 / 仅对授权会员开放 |
| 404 | model_not_found · channel_not_found | 平台未配置该模型;或所选渠道不存在 |
| 403 | model_not_granted | 模型仅对授权会员开放,当前账号未开通 |
| 403 | model_not_allowed_for_key | 该密钥的模型白名单不包含所请求的模型 |
| 403 | key_scope_denied | 该密钥的作用域不含本域名(如密钥限定为「仅网站基础产品接口」) |
| 403 | api_access_disabled | 账户未开启「开放 API 访问」总开关 |
余额相关的三条码,含义互不相同,请勿混为一谈:
insufficient_quota(没调用,充值后重试)·
balance_check_failed(没调用,是平台读余额失败,稍后重试)·
settle_shortfall(已经调用了,费用已发生、差额已挂账)。
平台绝不会在余额不足时先去调用上游、再把账单藏起来。
登录会员中心 → 左侧「账户」组 → API 密钥(/member/apikeys):
生成多把密钥,分别用于不同项目 每把可设有效期(7/30/90/180 天或长期) 每把可限定允许调用的模型 每把可选用途(如需限定为「仅 AI Token 接口」) 随时独立吊销
接口端点即为本页地址:https://aiapi.gzisp.net/v1/chat/completions