AI Token 开放接口（OpenAI 兼容）

1鉴权方式

所有请求需在请求头携带会员专属 API Key（在会员中心 /member/ai 生成，支持多把、可独立吊销、可限定有效期与可用模型）：

# 方式一：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 指向本接口域名即可。

示例（curl）

curl https://aiapi.gzisp.net/api/ai/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 结构。