pisite API Docs
返回首页 套餐 / 模型 服务状态 登录控制台 创建账号

Quick Start

从控制台复制示例，完成第一次 API 调用

推荐顺序：先看套餐和模型，注册或登录控制台，生成 API Key，复制控制台自动生成的 curl 示例，再上线前查看服务状态。

Step 1

查看套餐与模型

进入定价页确认可用套餐、模型价格、倍率、汇率和余额扣费规则。

Step 2

注册或登录

进入控制台，用邮箱和密码创建账号。试运行期间如果开启白名单，请先联系支持加入白名单。

Step 3

生成 API Key

登录后在控制台创建 API Key。完整 Key 只展示一次，请立即保存。

Step 4

复制示例并调用

控制台会把 Key 自动带入 curl 示例；这里的 `pi_xxx` 仅是占位。

进入控制台生成 Key 查看模型价格

OpenAI Compatible

Chat Completions

Base URL

https://your-domain.com/relay

curl 示例

curl https://your-domain.com/relay/v1/chat/completions \
  -H "Authorization: Bearer pi_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-flash",
    "messages": [{"role":"user","content":"hello"}],
    "temperature": 0,
    "max_tokens": 256
  }'

认证方式

Authorization: Bearer pi_xxx

这里使用的是你在 pisite 控制台生成的 API Key，不是上游厂商的 Key。

如果你刚生成 Key，请优先复制控制台里带完整 Key 的示例，因为完整 Key 离开页面后不会再次展示。

Models

查看可用模型

请求

curl https://your-domain.com/relay/v1/models \
  -H "Authorization: Bearer pi_xxx"

说明

返回结果会受套餐权限、后台模型定价、Provider 开关和渠道配置共同影响。

Errors

常见错误

状态码原因处理方式
401API Key 无效或未携带检查 Authorization header。
403套餐不允许、Provider 被关闭或限流检查套餐、模型权限和调用频率。
402余额不足充值或联系管理员加款。
404模型未配置定价联系运营在后台开启模型定价。
502上游渠道暂不可用稍后重试或联系运营切换渠道。