开发者 API 调用

本站兼容 OpenAI、Anthropic 和 Gemini 的官方接口。官方 SDK 和现成代码只要改两处：基础地址换成本站地址，密钥换成本站的 API 密钥。

接入地址

SDK 里只填基础地址，请求路径由 SDK 自己接上。能用哪种接口由密钥所在的分组决定：在 API 密钥 页面打开这把密钥的「更多连接选项」，「客户端协议」里只会列出这个分组支持的接口。Antigravity 分组的 Anthropic 和 Gemini 地址多一段 /antigravity，以密钥页面显示的为准。

传递密钥

把本站的 API 密钥放在请求头里，以下三种写法都可以：

• Authorization: Bearer 你的密钥（OpenAI 兼容客户端的默认写法）
• x-api-key: 你的密钥（Anthropic 客户端）
• x-goog-api-key: 你的密钥（Gemini 客户端）

不要把密钥写在网址参数里，本站会拒绝这种请求。也不要把密钥写进公开的代码仓库，建议放在环境变量里。

查看可用模型

用密钥请求模型列表，返回的就是这把密钥能用的模型：

curl https://aaaiapi.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

也可以在 API 密钥页面的「更多连接选项」里选择并复制模型 ID，或在模型广场查看。

调用示例

curl：

curl https://aaaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "填写模型 ID", "messages": [{"role": "user", "content": "你好"}]}'

$API_KEY 换成你的密钥，或者先在终端里设置同名环境变量。

Python（OpenAI SDK）：

from openai import OpenAI

client = OpenAI(base_url="https://aaaiapi.com/v1", api_key="你的 API 密钥")
reply = client.chat.completions.create(
    model="填写模型 ID",
    messages=[{"role": "user", "content": "你好"}],
)
print(reply.choices[0].message.content)

Python（Anthropic SDK，用于 Claude 分组）：

from anthropic import Anthropic

client = Anthropic(base_url="https://aaaiapi.com", api_key="你的 API 密钥")
reply = client.messages.create(
    model="填写模型 ID",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好"}],
)
print(reply.content[0].text)

Anthropic SDK 的 base_url 只填基础地址，SDK 会自己接上 /v1/messages。

请求失败时，按返回的状态码查常见问题。