文档 / 接入指南

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:降低并发,等一会儿再有限次重试。

超时或流式中断不代表上游没处理请求。重复提交可能产生新的扣费,先看使用日志再决定要不要重试。错误码对照见故障排查。

最后更新:2026-11-15。模型、价格和分组以控制台实时显示为准。