API 调用示例
下面的示例用 Bash / Zsh 和 curl。先选好协议对应的密钥和模型,替换占位符。每次成功调用都会扣费。
准备变量
export PEROAI_API_KEY='sk-你的密钥'
请求体里的模型 ID 要换成当前密钥分组里的完整模型 ID。切换协议时,同时检查密钥的分组。
OpenAI Chat Completions
适用于 GPT、Claude(claude-kiro)、Grok、Gemini 分组。
curl --fail-with-body -sS https://api.peroai.cc/v1/chat/completions \
-H "Authorization: Bearer $PEROAI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "gpt-6-astra",
"messages": [{"role": "user", "content": "你好,请简短回复。"}],
"stream": false
}'
成功后从 choices[0].message.content 读取回复。
OpenAI Responses
只适用于 GPT 分组,Codex 用的就是这个协议。
curl --fail-with-body -sS --no-buffer https://api.peroai.cc/v1/responses \
-H "Authorization: Bearer $PEROAI_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "gpt-6-astra",
"input": "请用一句话介绍你自己。",
"stream": true,
"store": false
}'
这是流式示例,返回内容是一段段 SSE 事件,不是一个完整的 JSON。程序里要按事件解析,不能对整个响应直接 JSON.parse。
Anthropic Messages
适用于 claude-kiro 分组。密钥放在 x-api-key 头里(放 Authorization: Bearer 也可以)。
curl --fail-with-body -sS https://api.peroai.cc/v1/messages \
-H "x-api-key: $PEROAI_API_KEY" \
-H 'anthropic-version: 2023-06-01' \
-H 'Content-Type: application/json' \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 128,
"messages": [{"role": "user", "content": "你好,请简短回复。"}]
}'
成功响应里的 content 是内容块数组。max_tokens 是本次输出上限。
claude-ccmax分组只接受 Claude Code 客户端的请求,用 curl 或 SDK 调用会返回 502。
用 SDK 接入自己的程序
Python(OpenAI SDK):
from openai import OpenAI
client = OpenAI(base_url="https://api.peroai.cc/v1", api_key="sk-你的密钥")
r = client.chat.completions.create(
model="gpt-6-astra",
messages=[{"role": "user", "content": "你好"}],
)
print(r.choices[0].message.content)
Python(Anthropic SDK):
from anthropic import Anthropic
client = Anthropic(base_url="https://api.peroai.cc", api_key="sk-你的密钥")
r = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=256,
messages=[{"role": "user", "content": "你好"}],
)
print(r.content[0].text)
Node.js(OpenAI SDK):
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.peroai.cc/v1", apiKey: process.env.PEROAI_API_KEY });
const r = await client.chat.completions.create({
model: "gpt-6-astra",
messages: [{ role: "user", content: "你好" }],
});
console.log(r.choices[0].message.content);
注意 Anthropic SDK 的 base_url 不带 /v1,OpenAI SDK 的带 /v1。先跑通一条纯文字请求,再加图片、工具调用等参数。
密钥要放在服务端的环境变量或密钥管理服务里,不要写进浏览器 JavaScript、手机安装包或公开仓库。网页应用请通过自己的服务端转发调用。
查询可用模型
curl -sS https://api.peroai.cc/v1/models -H "Authorization: Bearer $PEROAI_API_KEY"
返回这把密钥所在分组能用的模型列表。
超时和长请求
- 本站经 Cloudflare 接入,非流式请求 125 秒内没有返回会报 524。长输出、深度推理的请求请用流式(
"stream": true),流式请求每 30 秒会收到一次保活心跳,不受这个限制。 - 单次请求体上限 100 MB。
处理失败和重试
保存 HTTP 状态码、错误正文、发生时间,以及错误信息末尾的 request id。
- 401、403、400 等错误:先修正配置再试,重试不会变好。
- 429 或临时的 5xx:降低并发,等一会儿再有限次重试。