跳到正文
PrismRoute
English

从第一条请求开始。

一个基础地址、一枚 API 密钥，以及准确的模型 ID。选择与你的工作方式对应的指南，完成接入。

选择你的接入方式

Python配置官方 SDK，发送消息并读取流式文字。JavaScript使用 Node.js，明确设置服务端密钥与基础地址。Cherry Studio在桌面客户端中添加兼容 OpenAI 的服务商。CC Switch为 Claude Code 和 Codex 一键切换到 PrismRoute。常见问题检查接口、权限、超时与流式输出。
本页目录

连接信息

在兼容 OpenAI 的 SDK 中填写以下 API 基础地址。SDK 会追加接口路径，因此 /v1 只保留一次。

API 基础地址
https://codex.aicpr.icu/v1
设置项填写内容
身份验证Authorization: Bearer YOUR_PRISMROUTE_API_KEY
Chat CompletionsPOST /v1/chat/completions
Responses，需模型支持POST /v1/responses
模型 ID你的账户可以使用的准确模型 ID

准备密钥与模型

  1. 登录后打开 API 密钥页面，为应用创建密钥，并检查分组及模型限制。
  2. 打开模型目录，复制准确的模型 ID，确认它支持示例使用的接口。
  3. 在运行应用的同一个终端中设置环境变量，将两个占位值替换成你的真实配置。
macOS / Linux 终端
export PRISMROUTE_API_KEY="YOUR_PRISMROUTE_API_KEY"
export PRISMROUTE_MODEL="YOUR_MODEL_ID"
Windows PowerShell
$env:PRISMROUTE_API_KEY="YOUR_PRISMROUTE_API_KEY"
$env:PRISMROUTE_MODEL="YOUR_MODEL_ID"

密钥应保存在服务端或桌面客户端的私有设置中，不要放入公开仓库、浏览器前端代码或 URL。

发送 Chat Completions 请求

下面的 cURL 示例需要使用支持 Chat Completions 的模型。请替换 JSON 中的 YOUR_MODEL_ID，在准备好发送请求后再执行。

终端 · cURL
curl --fail-with-body https://codex.aicpr.icu/v1/chat/completions \
  -H "Authorization: Bearer $PRISMROUTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [{"role": "user", "content": "Hello, PrismRoute!"}]
  }'

成功后，从 choices[0].message.content 读取助手文字。出现错误时，请同时查看 HTTP 状态码与返回信息，再按排查指南逐项检查。

选择正确的请求格式

项目Chat CompletionsResponses
SDK 调用client.chat.completions.createclient.responses.create
输入字段messagesinput
文字输出choices[0].message.content官方 SDK 中的 output_text
流式输出choices[].delta按类型区分的事件，如 response.output_text.delta

OpenAI 建议在其自有 API 的新项目中采用 Responses，并继续支持 Chat Completions。使用 PrismRoute 时，请以所选模型实际开放的接口为准。Chat Completions 调用成功，不代表同时支持 Responses、托管工具或某款编程客户端。

技术参考