P 皮皮虾 AI DOCS 打开控制台

DEVELOPER DOCUMENTATION / 01

把模型接入，
从一个地址开始。

皮皮虾 AI 同时提供多个公开 API 端点。先按您当前网络选择一个端点，再将它填入任意兼容 OpenAI API 的客户端或代码。

开始配置 获取 API 密钥

CONNECTION / 02

选择当前 API 端点

所有教程会自动使用您在这里选择的地址。建议先在控制台的 API 密钥页面运行“连接检测”，再选择推荐端点。

当前选择默认端点
https://api.psydo.top/v1

这是兼容 OpenAI API 的 Base URL。大多数工具需要填写到 Base URL、API Host 或 Endpoint。

在控制台检测当前网络连接

QUICKSTART / 03

三步完成调用

  1. 01

    创建 API 密钥

    登录控制台，在“API 密钥”页面创建一个新的密钥。密钥只展示一次，请妥善保存。

  2. 02

    选择一个 API 端点

    使用上方端点选择器，或在控制台运行连接检测后使用被推荐的 URL。

  3. 03

    发送第一个请求

    将 Base URL、API Key 和模型名称填入客户端或下方代码示例。

cURL
curl "https://api.psydo.top/v1/chat/completions" \
  -H "Authorization: Bearer $PIPIXIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [{"role": "user", "content": "你好"}]
  }'

CLIENT GUIDES / 04

常用客户端配置

每个教程都使用当前选择的 API 端点。切换端点后，示例会即时更新。

01

CCSwitch

统一管理 Claude Code、Codex 等本地客户端的供应商、模型和 API 端点。

02

Cherry Studio

供应商选择 OpenAI，填写 Base URL 与 API Key，然后从模型列表添加可用模型。

03

Cursor

在模型提供商设置中启用 OpenAI Compatible，自定义 Base URL 并添加 API Key。

04

Claude Code

通过环境变量配置兼容端点与密钥，适合终端和自动化工作流。

05

OpenWebUI

在管理员连接配置中添加 OpenAI API 连接，保存后即可选择模型。

06

Python SDK

使用官方 OpenAI Python SDK，仅需设置 base_url 与 api_key。

07

Chatbox

在自定义 Provider 中使用 OpenAI API 兼容模式，填入 Base URL 与 API Key。

08

Cline / Roo Code

适合 VS Code 内的编码助手，选择 OpenAI Compatible 并填写端点与密钥。

09

Node.js / TypeScript

使用官方 OpenAI SDK，支持聊天、流式输出和 Responses API。

10

Java / Go

任何 HTTP 客户端都能调用兼容接口；文档提供最小可运行请求。

11

其他客户端

只要支持 OpenAI API 兼容格式，通常都能接入皮皮虾 AI。

查看兼容原则 →

API REFERENCE / 05

常用接口示例

示例只展示请求格式。模型名称、可用能力和额度以控制台当前模型列表及您的权限为准。

聊天补全

POST /v1/chat/completions

流式输出

stream: true

Responses

POST /v1/responses

图片生成

POST /v1/images/generations

模型列表

GET /v1/models

TROUBLESHOOTING / 06

错误排查

先保留请求 ID 和状态码，再按下面顺序排查。不要在截图、工单或聊天中发送完整 API Key。

状态常见原因先做什么
401

API Key 缺失、写错、已删除，或请求头格式不正确。

确认使用 Authorization: Bearer API_KEY，重新创建并替换密钥。

403

当前密钥、分组或账号没有该模型的访问权限；也可能是上游拒绝。

在控制台确认模型可见、分组已授权；持续出现时保留请求 ID 联系支持。

404

Base URL、路径或模型名称不正确。

Base URL 通常填 /v1；模型名以控制台模型列表为准，不要照抄其他平台名称。

429

可能是请求频率/并发达到限制，也可能是余额不足、套餐权益或模型配额已耗尽。

先检查控制台余额、用量和套餐/分组权益；余额正常后再降低并发、稍后重试。不要只把 429 当成“限流”。

5xx

可能来自上游模型服务、短暂网络波动或请求负载异常。

使用指数退避重试；若只在一个端点出现，可运行连接检测并切换推荐 URL。持续失败请提供时间、模型和请求 ID。

REFERENCE / 07

接入说明

多个 API 端点有什么区别？

它们提供相同的 API 能力、账户体系和可用模型。区别仅在您当前网络到公开入口的连接表现。可在控制台运行连接检测，优先使用推荐 URL。

更换端点会影响余额、套餐或 API Key 吗？

不会。端点是访问地址，不是新账户或新线路套餐。更换后仍使用同一 API Key、同一余额和同一订阅权益。

生图为什么要单独创建 API Key？

API Key 会绑定一个 API 分组。请保留 Claude/Codex 当前使用的编程分组 Key，并额外创建一把绑定“生图 API 分组”的 Key 给图片生成客户端或脚本使用。两把 Key 属于同一账户，余额和套餐权益不需要重复购买；差别只在各自可访问的分组和模型。

为什么模型名称和官方示例不同？

请以控制台模型列表为准。不同分组、套餐和权限可能看到不同模型；不要把文档中的示例模型名当作固定可用清单。

连接检测“不推荐”代表什么？

只代表测试时您的当前设备和网络访问该 URL 的表现较差，不代表模型不可用或该端点对所有人都不好。可以切换其他 URL 后重新检测。

收到 429 是不是一定触发限流？

不是。429 既可能是瞬时请求频率或并发过高，也可能表示余额不足、套餐权益不足，或者特定模型配额已用完。请先检查控制台余额、用量和套餐权益，再考虑降低并发或稍后重试。

CLIENT GUIDE