AI Token 开放接口(OpenAI 兼容)

本域名(aiapi.gzisp.net)是 AI Token 的专用开放接口。接口地址:https://aiapi.gzisp.net/v1/chat/completions;当前已由管理员关闭,暂不可调用。

⚠️ 本平台 API 服务当前未开放。 管理员已在后台关闭对外 API:本页所有端点此刻都会返回 403 api_global_disabled(密钥正确也一样;你的 Token 余额、密钥与配额都会被保留,开放后原样可用)。 本页仅作接入说明保留,请等平台开放后再联调。

i域名用途说明

我们按产品类型拆分了对外 API 域名:

1鉴权方式

所有请求需在请求头携带会员专属 API Key(在会员中心 /member/apikeys 生成,支持多把、可独立吊销、可限定有效期与可用模型):

# 方式一:Authorization 头(推荐)
Authorization: Bearer sk-你的密钥

# 方式二:X-Api-Key 头(便于部分 SDK / 代理)
X-Api-Key: sk-你的密钥

# 方式三:查询参数(仅调试用)
?api_key=sk-你的密钥

密钥明文仅在生成时显示一次,请妥善保存。泄露后可随时在会员中心吊销,对应 Agent 立即失效。

2对话补全(Chat Completions)

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)

3响应与错误码

成功返回标准 OpenAI chat.completion 对象(含 usage);错误返回 OpenAI 兼容 error 结构。

HTTPcode含义
401invalid_api_key缺少或无效的 API Key
400invalid_request_error请求体缺 model / messages 等参数问题
400invalid_model · invalid_messages · invalid_provider_id参数级失败(网关返回的细分码,message 里有说明)
400insufficient_quotaToken 余额不足:低估不了,平台在调用上游之前就已拦截,本次未调用任何模型、未产生任何费用。充值后重试即可
402settle_shortfall已调用、但结算不足:上游已完成、费用已发生,差额已挂账。不可当作「未执行」,请充值后继续
503balance_check_failed余额校验本身失败(读取异常)。按 fail-closed 处理:不调用上游、不产生费用,稍后用同一请求重试即可
502upstream_failed上游厂商调用失败(网络 / 鉴权 / 限流等)。平台侧未扣费,可重试
403channel_disabled · channel_not_authorized · channel_not_granted渠道已停用 / 未通过平台合规授权 / 仅对授权会员开放
404model_not_found · channel_not_found平台未配置该模型;或所选渠道不存在
403model_not_granted模型仅对授权会员开放,当前账号未开通
403model_not_allowed_for_key该密钥的模型白名单不包含所请求的模型
403key_scope_denied该密钥的作用域不含本域名(如密钥限定为「仅网站基础产品接口」)
403api_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

本接口由系统自动生成文档 · 直接访问对外 API 域名(aiapi.gzisp.net)即看到此页 · 业务调用请用会员中心签发的密钥