pisite 文档
← 返回主页 定价 状态
控制台

Quick Start

选择你的工具，复制配置即用

三步上手，再按工具选场景。所有示例都用真实可粘贴的 Base URL 和模型 ID。

01

注册并登录

邮箱密码即可。试运行期间如开启白名单，请先联系支持。

02

生成 API Key

控制台 → 创建 Key。完整 Key 只显示一次，立即复制。

03

复制配置开调

在下方场景卡里找到你的工具，把 Base URL、Key、模型 ID 三项填进去。

进入控制台 查看模型与价格

三个共用字段

Base URL
https://api.pisite.ai/relay/v1

末尾必须是 /v1，不要多斜杠。

API Key
你在控制台生成的 pi_xxx

用 pisite 自己的 Key，不是 OpenAI / Anthropic 官方 Key。

模型 ID（Model）
见下方模型表，按需粘贴

模型 ID 大小写敏感，整段复制粘贴最稳。

选择模型 ID

把下面这一列直接粘贴到工具的「模型」字段。

用途 Model ID（直接粘贴） 走哪条协议
日常聊天 / 代码助手 claude-sonnet-4-20250514 Anthropic 原生
长上下文 / 复杂推理 claude-opus-4-20250514 Anthropic 原生
日常聊天 / 代码助手 gpt-4o OpenAI 兼容
便宜 / 高频小请求 gpt-4o-mini OpenAI 兼容
深度推理（OpenAI o 系列） o1 OpenAI 兼容
Google Gemini gemini-2.5-flash OpenAI 兼容

按工具选场景

选你正在用的工具，复制整段即可。

Python

Python（OpenAI SDK 调任意模型）

最简上手。装 openai 包，把 base_url 指过来。

pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="pi_xxx",                         # 控制台生成的 pisite Key
    base_url="https://api.pisite.ai/relay/v1",  # 末尾必须 /v1
)

resp = client.chat.completions.create(
    model="gemini-2.5-flash",                 # 换模型只改这里
    messages=[{"role": "user", "content": "你好"}],
)

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

换 Claude / GPT 时只改 model 字段，其他不动。

Node.js

Node.js（OpenAI SDK）

TypeScript / Node 18+ 项目。同样改 baseURL 即可。

npm i openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.PISITE_KEY,            // pi_xxx
  baseURL: "https://api.pisite.ai/relay/v1",  // 末尾必须 /v1
});

const resp = await client.chat.completions.create({
  model: "claude-sonnet-4-20250514",         // 换模型只改这里
  messages: [{ role: "user", content: "你好" }],
});

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

Anthropic 模型也走这里，model 直接写 claude-sonnet-4-20250514。

curl

curl（最快验证 Key 是否能用）

复制粘贴到终端，立刻看返回。

curl https://api.pisite.ai/relay/v1/chat/completions \
  -H "Authorization: Bearer pi_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-flash",
    "messages": [{"role":"user","content":"你好"}]
  }'
Cursor

Cursor IDE

把 pisite 设为自定义 OpenAI 服务，整个 IDE 的 AI 都走 pisite。

  1. Cursor → Settings → Models
  2. 打开 OpenAI API Key 开关，点 Override OpenAI Base URL
  3. Base URL 填：${origin}/relay/v1（末尾必须 /v1） https://api.pisite.ai/relay/v1
  4. API Key 填你的 pi_xxx
  5. 在 Model Names 里手动添加要用的模型 ID（每行一个）

建议加这几个：

claude-sonnet-4-20250514
gpt-4o
gemini-2.5-flash

点 Verify，返回成功即可。失败先检查 Base URL 末尾是否多斜杠。

记得关掉 Cursor 自带的 GPT/Claude 开关，否则它优先走 Cursor 服务器。

Cline

Cline（VS Code 扩展）

Provider 选 OpenAI Compatible 最稳。

  1. VS Code 安装 Cline 扩展，打开侧边栏
  2. API Provider 选 OpenAI Compatible
  3. Base URL 填：${origin}/relay/v1 https://api.pisite.ai/relay/v1
  4. API Key 填你的 pi_xxx
  5. Model ID 填一个上面表里的 ID，例如 claude-sonnet-4-20250514

代理把 SSE 截断会导致流式中断，把 VS Code http.proxySupport 设为 off。

想用原生 Anthropic 协议？

Provider 选 Anthropic，Custom Base URL 填 ${origin}/relay（不带 /v1，由 Cline 自己拼 /v1/messages）。

OpenAI 兼容客户端

其它 OpenAI 兼容客户端

凡是允许填自定义 Base URL 的 OpenAI 客户端都能接。

客户端 在哪个字段填 Base URL 填什么
NextChat OpenAI Endpoint https://api.pisite.ai/relay/v1
ChatBox API Host https://api.pisite.ai/relay/v1
lobe-chat Custom Endpoint https://api.pisite.ai/relay/v1
Open WebUI OpenAI API Base URL https://api.pisite.ai/relay/v1

调不通时怎么排查

按现象对照，一步解决。

现象 最可能原因 一步解决
401 Unauthorized Key 错或已停用 回控制台重新生成 Key
402 Insufficient balance 余额不足 去充值，或换便宜模型
404 Model not found 模型 ID 拼错 / 套餐不含该模型 回上面模型表整段复制
502 / 504 上游临时故障 等 30 秒重试，或换模型
Cursor Verify failed Base URL 末尾多 / 或少 /v1 改成 ${origin}/relay/v1
Cline 流式中断 代理吃掉 SSE VS Code http.proxySupport 设 off