三步接入

AIAPIZZ 提供与官方完全一致的接口格式，接入只需要换掉一个地址：

1. 在控制台「API 密钥」里创建一个密钥（形如 sk-xxxxxxxx），并给它勾选允许调用的模型；
2. 把官方 SDK 的 base_url 换成 https://aiapizz.com/v1（本站若有多条线路，任选一条，见《接口地址与线路》）；
3. 用你的密钥替换官方 key，其余参数一行都不用改。

最小示例

curl

curl https://aiapizz.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "用一句话解释什么是向量数据库"}]
  }'

Python（openai 官方 SDK）

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的密钥",
    base_url="https://aiapizz.com/v1",
)

r = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "用一句话解释什么是向量数据库"}],
)
print(r.choices[0].message.content)

Node.js（openai 官方 SDK）

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-你的密钥",
  baseURL: "https://aiapizz.com/v1",
});

const r = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "用一句话解释什么是向量数据库" }],
});
console.log(r.choices[0].message.content);

三种格式的地址对照

三种格式可以同时使用，同一个密钥都能调，返回体格式跟请求格式一一对应：

> 不确定选哪个？直接用 OpenAI 格式，兼容的 SDK 和客户端最多。

第一次调用要检查的事

• 密钥是否已创建，并且模型范围里勾了你要调的模型（留空表示不限）；
• 账户余额是否大于 0（余额为 0 时网关会直接返回 402）；
• 请求里的 model 必须是「模型广场」里展示的模型名，未上架的模型会返回 404；
• 流式请求（"stream": true）记得让反向代理关掉缓冲，见《流式输出》一篇。

接下来看什么

• 想搞清楚认证方式、密钥权限：看《认证与密钥》；
• 要接 Anthropic 或 Gemini：看对应的格式章节；
• 想换线路、或某条线路连不上：看《接口地址与线路》；
• 接不上的时候：先看《错误码速查》，90% 的问题在那一页。