# 棱镜 PRISM 接入指南
更新日期：2026-09-23
在线文档：https://prismind.one/TTAPI/
## 从这里开始
准备好账号和 API 密钥，即可将 Codex、OpenClaw 或自己的应用接入 棱镜 PRISM。
### 开通账号
注册登录，查看余额与订阅。
### 创建密钥
选择分组，获取专属 API Key。
### 接入应用
配置地址与密钥，发送首个请求。
### 接入地址
| 用途 | 地址 |
| --- | --- |
| 棱镜 PRISM 站点 | [https://prismind.one](https://prismind.one/) |
| API Base URL | `https://prismind.one/v1` |
| Responses 接口 | `POST https://prismind.one/v1/responses` |
| 模型列表 | `GET https://prismind.one/v1/models` |
| 本文档 | [https://prismind.one/TTAPI/](https://prismind.one/TTAPI/) |
**地址怎么填？**
客户端要求填写 Base URL 时使用 `https://prismind.one/v1`。如果字段明确要求完整请求地址，才填写 `https://prismind.one/v1/responses`。不要重复拼接 `/v1`，也不要把控制台页面地址填进接口配置。
以下 Codex 与 Responses 文本请求以 `gpt-5.5` 演示配置。模型是否可用取决于 API 密钥所属分组、订阅权限与服务状态，以控制台「使用密钥」提供的接入信息为准。
## 熟悉的模型，一处接入。
从文字与代码，到想象中的画面。选择适合任务的模型，把时间留给创造。
### Claude
思考 · 写作 · 编程
### GPT
理解 · 推理 · 创造
### Grok
对话 · 探索 · 灵感
### GPT Image 2.5
图像 · 视觉 · 想象
以上为模型系列与产品名称。请求中的具体模型 ID、接入协议和可用额度，请在[控制台 → API 密钥 → 使用密钥](https://prismind.one/keys)中按所选分组确认。下文的 Responses 文本示例不作为所有模型或图片接口的通用配置。
稳定可靠用多少，付多少一键接入
## 01 / 注册与兑换
### 新用户
1. 打开 [注册页面](https://prismind.one/register)，按页面提示完成注册；已有账号可直接[登录](https://prismind.one/login)。
1. 持有兑换码时，进入[兑换页面](https://prismind.one/redeem)输入并提交。兑换码可用于余额或订阅，具体以兑换结果为准。
1. 余额类兑换后查看[仪表盘](https://prismind.one/dashboard)；订阅类兑换后查看[我的订阅](https://prismind.one/subscriptions)，确认分组、有效期和可用额度。
### 已有账号
直接进入兑换页面提交新的兑换码，并核对兑换记录。订阅激活后，在创建 API 密钥时选择与订阅对应的分组。
**余额与订阅分别查看**
兑换成功并不一定会增加账户余额。若兑换的是订阅，请到「我的订阅」确认状态。失败时保留错误提示与操作时间，勿在公开渠道发送完整兑换码。
## 02 / 创建 API 密钥
1. 进入[API 密钥](https://prismind.one/keys)页面，点击「创建密钥」。
1. 按用途命名，例如 `codex-work` 或 `openclaw-main`。
1. 选择有使用权限的分组，核对该分组支持的模型、计费与额度。
1. 保存密钥后点击「使用密钥」，获取接入说明。不同客户端、分组或认证模式可能提供不同参数。
1. 复制密钥到自己的客户端或环境变量中，保存后发送一次简短请求验证。
建议为不同应用分别创建密钥，便于查看消耗与停用。密钥泄漏时立即停用或删除，并在相关客户端更换；不要将真实密钥提交到代码仓库、截图或公开聊天中。
## 03 / 安装 Codex
### VS Code 插件
1. 打开 VS Code 的扩展市场，搜索 `Codex`。
1. 核对发布者为 OpenAI，安装官方扩展。
1. 安装后打开 Codex 面板，按下一节配置用户级接入信息；更新配置后重新加载 VS Code。
### Codex CLI
先安装受当前 Codex 版本支持的 Node.js，再打开终端。Windows 可使用 PowerShell；macOS 或 Linux 可使用系统终端。
```bash
node -v
npm -v
npm install -g @openai/codex
codex --version
```
若提示找不到 `node`、`npm` 或 `codex`，先检查安装是否成功、可执行文件是否在 PATH 中，并重新打开终端。
## 04 / 配置 Codex 接入
优先使用控制台 [API 密钥 → 使用密钥](https://prismind.one/keys) 提供的配置。下面是通过环境变量读取密钥的最小示例，适用于支持自定义 Responses 提供商的 Codex CLI。
### 1. 编辑用户级配置
macOS / Linux：`~/.codex/config.toml`；Windows：`%USERPROFILE%\.codex\config.toml`。如果自定义了 `CODEX_HOME`，使用该目录下的 `config.toml`。
先备份已有文件，再合并以下字段。顶层的 `model` 与 `model_provider` 应放在 TOML 表头之前；同名配置表只保留一份。
```toml
model_provider = "banana"
model = "gpt-5.5"
[model_providers.banana]
name = "棱镜 PRISM"
base_url = "https://prismind.one/v1"
wire_api = "responses"
env_key = "BANANA_API_KEY"
requires_openai_auth = false
```
[下载 config.toml 示例 ↓](https://prismind.one/TTAPI/downloads/config.toml)
**已有配置可继续使用**
本版示例沿用 `banana` 和 `BANANA_API_KEY` 作为本地配置标识，以兼容已有客户端；它们不是站点品牌名称。品牌视觉更新不要求已有配置迁移，服务地址与已有 API 密钥保持有效。
### 2. 设置密钥环境变量
把占位值替换为自己的 API Key。以下命令仅对当前终端会话有效；需要持久配置时，请使用系统环境变量或受保护的本地配置。
```bash
export BANANA_API_KEY="替换为你的API密钥"
codex
```
```powershell
$env:BANANA_API_KEY = "替换为你的API密钥"
codex
```
**VS Code 与桌面客户端**
从桌面图标启动的应用通常不会继承某个终端临时设置的环境变量。请使用控制台提供的对应客户端配置，或为应用进程设置环境变量后完全退出并重启应用。从已经设置变量的终端启动 VS Code 时，先确保没有旧的 VS Code 进程继续复用。
### 3. 验证接入
新建会话，发送一句简短文本。需要使用编程工具时，再在允许读取的测试目录里请求一次只读文件查看，并确认能返回结果。能聊天不代表所有工具协议均已验证；遇到工具不可用时，按[常见问题](https://prismind.one/TTAPI/#faq)排查。
## 05 / 发送 API 请求
请求使用 `Authorization: Bearer ` 认证。下面使用上一节已设置的 `BANANA_API_KEY`。模型列表查询可用于检查认证；生成请求会按所选分组规则计费。
### 查询模型列表 · macOS / Linux
```bash
curl --fail-with-body "https://prismind.one/v1/models" \
-H "Authorization: Bearer $BANANA_API_KEY"
```
### 发送文本请求 · macOS / Linux
```bash
curl --fail-with-body "https://prismind.one/v1/responses" \
-H "Authorization: Bearer $BANANA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.5","input":"请回复：连接成功","stream":false}'
```
### 发送文本请求 · Windows PowerShell
```powershell
$headers = @{ Authorization = "Bearer $env:BANANA_API_KEY" }
$body = @{ model = "gpt-5.5"; input = "Reply: connected"; stream = $false } | ConvertTo-Json
Invoke-RestMethod -Method Post -Uri "https://prismind.one/v1/responses" -Headers $headers -ContentType "application/json" -Body $body
```
若模型列表或生成请求返回权限错误，核对密钥分组、订阅状态与模型名称。客户端有时会使用自己的模型目录；最终可用性仍需结合该密钥的接入说明与实际请求结果判断。
## 06 / OpenClaw 接入
### 手动合并配置
备份 `~/.openclaw/openclaw.json`，将以下片段合并到现有配置中，并为 OpenClaw 进程设置 `BANANA_API_KEY` 环境变量。作为后台服务运行时，应配置服务进程的环境变量。
```json
{
"models": {
"mode": "merge",
"providers": {
"banana": {
"baseUrl": "https://prismind.one/v1",
"apiKey": "${BANANA_API_KEY}",
"api": "openai-responses",
"authHeader": true,
"models": [
{
"id": "gpt-5.5",
"name": "gpt-5.5"
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "banana/gpt-5.5"
}
}
}
}
```
[下载 OpenClaw 配置片段 ↓](https://prismind.one/TTAPI/downloads/openclaw.example.json)
**保持模型名称一致**
示例中的模型 ID 是 `gpt-5.5`，默认模型是 `banana/gpt-5.5`。更换模型时两处一起修改。已有模型白名单时，也要按当前 OpenClaw 版本要求加入对应模型。配置中不填写未经确认的上下文上限或价格；客户端估算费用不等于 棱镜 PRISM 实际账单。
合并配置时保留已有的频道、工作区、工具权限和其他提供商设置。使用当前安装版本的配置校验方式确认格式正确，再按该版本要求重载或重启，并测试文本请求和一次允许的只读工具调用。
### 让外部 AI 助手协助配置
可以将下面的任务说明发给有权限管理本机配置的助手。无需安装来源未核实的 Skill，也不需要把真实密钥贴进提示词。
```text
请协助把我的 OpenClaw 接入 棱镜 PRISM。
接入文档：https://prismind.one/TTAPI/
API Base URL：https://prismind.one/v1
协议：openai-responses
模型示例：gpt-5.5，以我的密钥所属分组实际支持的模型为准。
密钥从 BANANA_API_KEY 环境变量读取，不要输出密钥。
先核对本机 OpenClaw 版本与配置格式，备份现有配置，
合并 banana 提供商并保持模型 ID 与默认模型一致。
保留已有频道、工具权限和工作区设置。
校验通过后测试一次简短文本请求和一次只读工具调用，
报告实际结果；失败时说明原因并提供恢复方式。
```
## 07 / 常见问题
先记下错误码、发生时间和请求 ID，再按对应条目检查。相同错误码可能来自客户端、网关或上游，需结合响应内容判断。
### 401 / 403密钥或访问权限异常
确认使用的是 棱镜 PRISM 的 API 密钥，检查复制时是否带入空格、环境变量是否被应用读取，以及密钥是否被停用。再核对请求地址、分组权限、订阅有效期和 IP 限制等设置。不要把网页登录密码当作 API Key。
### 404地址或模型不存在
检查 Base URL 是否为 `https://prismind.one/v1`，避免重复添加 `/v1`。如果响应为 `model_not_found`，检查当前分组支持的模型；模型不存在不等于 Responses 接口不存在。
### 415Unsupported Media Type
发送 JSON 时设置 `Content-Type: application/json`，确认请求体格式与接口匹配。使用客户端时核对版本、提供商与认证配置。仅凭 415 不能确定是旧登录状态导致，先检查实际响应和请求格式。
### 429请求频率或额度受限
查看错误信息和响应中的重试提示，降低并发并间隔重试。检查分组限流、订阅额度、账户余额和上游限制。不要开启无间隔的自动重试循环。
### 502 / 503服务暂时不可用
可能涉及上游异常、可用通道不足或网关问题。稍后重试并查看站内公告；持续出现时向客服提供时间、模型和请求 ID。不要仅根据状态码认定为“上游满载”。
### STREAM流式中断 / stream disconnected
检查网络、代理和客户端超时。可对比直连与代理线路，确认 `prismind.one` 的连通性。流式中断也可能由上游或服务端超时引起；重复提交前先检查用量记录，避免同一任务重复消耗。没有接入说明依据时，不要自行把接口路径改为 `/codex`。
### CONTEXT上下文压缩失败或对话过长
保存必要的任务摘要后开启新会话，减少重复文件、过大的工具输出和无关历史。记录客户端版本、模型与具体错误。不要依赖修改提供商显示名称来控制压缩；压缩行为应以当前客户端和通道支持的配置为准。
### TOOLS可以聊天，但没有 Shell 或工具调用失败
检查客户端是否启用了所需工具、当前目录和执行权限是否允许。Codex 还需要通道正确支持 Responses 及工具调用的往返。向客服提供客户端版本、模型、发生时间和请求 ID，协助核对通道协议。服务端配置不能替代客户端的权限授权。
### ACCOUNT兑换后额度没变化 / 模型列表异常
先区分余额兑换与订阅兑换，在[仪表盘](https://prismind.one/dashboard)和[我的订阅](https://prismind.one/subscriptions)分别核对。模型列表异常时检查密钥分组、接入参数和客户端缓存，重启客户端后再验证。仍有问题时提供脱敏截图与操作时间。
## 08 / 用量与日常管理
### 每日查看什么
- [仪表盘](https://prismind.one/dashboard)：余额、请求数、消费和 Token 用量趋势。
- [使用记录](https://prismind.one/usage)：请求时间、模型、密钥与消耗，结合错误发生时间定位。
- [我的订阅](https://prismind.one/subscriptions)：分组、有效期和剩余额度。
### 费用突然增加
先查看请求数量是否异常，再检查长上下文、重复重试、循环任务、后台任务与模型选择。不同分组和模型可能采用不同计费规则，以平台显示和实际账单为准，不将某个上下文长度对应的倍率视为统一规则。
### 密钥怎么管理
按应用分别命名，定期停用不再使用的密钥。需要轮换时先验证新密钥，再停用旧密钥；发现泄漏则立即停用并排查异常用量。
## 09 / 文档与配置下载
模板中的密钥为占位值，下载后按自己的环境合并配置。下面的文件均由 棱镜 PRISM 文档站提供。
- [**完整接入文档** — Markdown · 可离线阅读和编辑↓](https://prismind.one/TTAPI/downloads/prism-guide.md)
- [**Codex 配置示例** — TOML · 用户级提供商配置↓](https://prismind.one/TTAPI/downloads/config.toml)
- [**OpenClaw 配置片段** — JSON · 合并到已有配置↓](https://prismind.one/TTAPI/downloads/openclaw.example.json)
## 需要帮助？
客服联系方式：**1090404058**。如联系方式调整，以 棱镜 PRISM 控制台公布的信息为准。
请准备账号标识、客户端名称与版本、模型、发生时间、完整错误提示或请求 ID，以及已做过的排查步骤。密钥仅提供名称或脱敏标识。
[打开 棱镜 PRISM 控制台 ](https://prismind.one/dashboard)