API 用户配置文档

快速开始 ​

5 分钟跑通第一次 API 调用。

默认走 Chat Completions

本页使用 OpenAI 兼容的 /v1/chat/completions 接口。所有公开模型（GPT / Claude / Gemini / Qwen / GLM / DeepSeek / Kimi）都可以通过这条接口调用，是默认推荐路径。

如果你的客户端只能用 Anthropic 协议（Claude Code CLI、Claude 官方桌面端等），请参考 Messages（Anthropic 兼容） 和 Claude 系列客户端接入。

1. 取得 API Key ​

API Key 由运营方通过邮件分配。如尚未取得，发送邮件到 info@aiqizhilian.tech 申请。

API Key 形如：sk-xxxxxxxxxxxxxxxxxxxxxxxx。

保管 API Key

请妥善保管 API Key。不要写入前端代码、公开仓库、日志或截图。

2. 测试连通性 ​

把下面的命令贴到终端（替换 <你的 API Key>）：

bash
curl https://api.aiqizhilian.tech/v1/chat/completions \
  -H "Authorization: Bearer <你的 API Key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "用一句话介绍你自己"}],
    "max_tokens": 256
  }'

正常会返回类似：

json
{
  "id": "chatcmpl-xxx",
  "model": "gpt-5.5",
  "choices": [
    {
      "message": { "role": "assistant", "content": "..." },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 12, "completion_tokens": 18, "total_tokens": 30 }
}

3. 用 SDK 接入 ​

Python（OpenAI SDK） ​

python
from openai import OpenAI

client = OpenAI(
    api_key="<你的 API Key>",
    base_url="https://api.aiqizhilian.tech/v1",
)

resp = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "用一句话介绍大模型"}],
    max_tokens=256,
)

print(resp.choices[0].message.content)

Node.js（OpenAI SDK） ​

javascript
import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: process.env.API_KEY,
  baseURL: 'https://api.aiqizhilian.tech/v1',
})

const resp = await client.chat.completions.create({
  model: 'gpt-5.5',
  messages: [{ role: 'user', content: '用一句话介绍大模型' }],
  max_tokens: 256,
})

console.log(resp.choices[0].message.content)

4. 查询可用模型 ​

bash
curl https://api.aiqizhilian.tech/v1/models \
  -H "Authorization: Bearer <你的 API Key>"

完整模型清单与各自适用场景见 可用模型。

5. 接下来 ​

按接口选：

按客户端选：

排障：

接入自查清单 ​

  • [ ] 已收到分配的 API Key
  • [ ] 请求地址使用 https://api.aiqizhilian.tech/v1/chat/completions
  • [ ] 请求头包含 Authorization: Bearer <你的 API Key>
  • [ ] model 字段使用文档列出的模型名（与 /v1/models 返回一致）
  • [ ] API Key 保存在服务端环境变量，不在浏览器前端暴露
  • [ ] 生产代码已配置超时、重试、错误日志和 JSON 解析兜底