一束光。
万种可能。

从这里开始

准备好账号和 API 密钥，即可将 Codex、OpenClaw 或自己的应用接入 棱镜 PRISM。

接入地址

以下 Codex 与 Responses 文本请求以 gpt-5.5 演示配置。模型是否可用取决于 API 密钥所属分组、订阅权限与服务状态，以控制台「使用密钥」提供的接入信息为准。

熟悉的模型，一处接入。

从文字与代码，到想象中的画面。选择适合任务的模型，把时间留给创造。

以上为模型系列与产品名称。请求中的具体模型 ID、接入协议和可用额度，请在控制台 → API 密钥 → 使用密钥中按所选分组确认。下文的 Responses 文本示例不作为所有模型或图片接口的通用配置。

01 / 注册与兑换

新用户

1. 打开 注册页面，按页面提示完成注册；已有账号可直接登录。
2. 持有兑换码时，进入兑换页面输入并提交。兑换码可用于余额或订阅，具体以兑换结果为准。
3. 余额类兑换后查看仪表盘；订阅类兑换后查看我的订阅，确认分组、有效期和可用额度。

已有账号

直接进入兑换页面提交新的兑换码，并核对兑换记录。订阅激活后，在创建 API 密钥时选择与订阅对应的分组。

02 / 创建 API 密钥

1. 进入API 密钥页面，点击「创建密钥」。
2. 按用途命名，例如 codex-work 或 openclaw-main。
3. 选择有使用权限的分组，核对该分组支持的模型、计费与额度。
4. 保存密钥后点击「使用密钥」，获取接入说明。不同客户端、分组或认证模式可能提供不同参数。
5. 复制密钥到自己的客户端或环境变量中，保存后发送一次简短请求验证。

建议为不同应用分别创建密钥，便于查看消耗与停用。密钥泄漏时立即停用或删除，并在相关客户端更换；不要将真实密钥提交到代码仓库、截图或公开聊天中。

03 / 安装 Codex

VS Code 插件

1. 打开 VS Code 的扩展市场，搜索 Codex。
2. 核对发布者为 OpenAI，安装官方扩展。
3. 安装后打开 Codex 面板，按下一节配置用户级接入信息；更新配置后重新加载 VS Code。

Codex CLI

先安装受当前 Codex 版本支持的 Node.js，再打开终端。Windows 可使用 PowerShell；macOS 或 Linux 可使用系统终端。

node -v
npm -v
npm install -g @openai/codex
codex --version

若提示找不到 node、npm 或 codex，先检查安装是否成功、可执行文件是否在 PATH 中，并重新打开终端。

04 / 配置 Codex 接入

优先使用控制台 API 密钥 → 使用密钥 提供的配置。下面是通过环境变量读取密钥的最小示例，适用于支持自定义 Responses 提供商的 Codex CLI。

1. 编辑用户级配置

macOS / Linux：~/.codex/config.toml；Windows：%USERPROFILE%\.codex\config.toml。如果自定义了 CODEX_HOME，使用该目录下的 config.toml。

先备份已有文件，再合并以下字段。顶层的 model 与 model_provider 应放在 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 示例 ↓

2. 设置密钥环境变量

把占位值替换为自己的 API Key。以下命令仅对当前终端会话有效；需要持久配置时，请使用系统环境变量或受保护的本地配置。

export BANANA_API_KEY="替换为你的API密钥"
codex

$env:BANANA_API_KEY = "替换为你的API密钥"
codex

3. 验证接入

新建会话，发送一句简短文本。需要使用编程工具时，再在允许读取的测试目录里请求一次只读文件查看，并确认能返回结果。能聊天不代表所有工具协议均已验证；遇到工具不可用时，按常见问题排查。

05 / 发送 API 请求

请求使用 Authorization: Bearer <API_KEY> 认证。下面使用上一节已设置的 BANANA_API_KEY。模型列表查询可用于检查认证；生成请求会按所选分组规则计费。

查询模型列表 · macOS / Linux

curl --fail-with-body "https://prismind.one/v1/models" \
  -H "Authorization: Bearer $BANANA_API_KEY"

发送文本请求 · macOS / Linux

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

$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 环境变量。作为后台服务运行时，应配置服务进程的环境变量。

{
  "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 配置片段 ↓

合并配置时保留已有的频道、工作区、工具权限和其他提供商设置。使用当前安装版本的配置校验方式确认格式正确，再按该版本要求重载或重启，并测试文本请求和一次允许的只读工具调用。

让外部 AI 助手协助配置

可以将下面的任务说明发给有权限管理本机配置的助手。无需安装来源未核实的 Skill，也不需要把真实密钥贴进提示词。

请协助把我的 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，再按对应条目检查。相同错误码可能来自客户端、网关或上游，需结合响应内容判断。

08 / 用量与日常管理

每日查看什么

• 仪表盘：余额、请求数、消费和 Token 用量趋势。
• 使用记录：请求时间、模型、密钥与消耗，结合错误发生时间定位。
• 我的订阅：分组、有效期和剩余额度。

费用突然增加

先查看请求数量是否异常，再检查长上下文、重复重试、循环任务、后台任务与模型选择。不同分组和模型可能采用不同计费规则，以平台显示和实际账单为准，不将某个上下文长度对应的倍率视为统一规则。

密钥怎么管理

按应用分别命名，定期停用不再使用的密钥。需要轮换时先验证新密钥，再停用旧密钥；发现泄漏则立即停用并排查异常用量。

09 / 文档与配置下载

模板中的密钥为占位值，下载后按自己的环境合并配置。下面的文件均由 棱镜 PRISM 文档站提供。