ORDERS
API CREDITS
钱包充值
START HERE
选择你的接入方式
正在读取试用状态…AVAILABLE BALANCEɌ—
USD
UNUSED CREDITS申请余额退款按钱包中未使用的付费额度计算，关联赠送额度会收回。
LEDGER
资金变动
ACCOUNT
注销账户
CODEXY REFERRAL EARNINGS
邀请好友，赚取可提现 USDT。
达标奖励10 USDT
+
长期返利5%
达标邀请金 + 长期返利
好友累计有效充值满 US$50，你得 10 USDT；其后每次充值再得 5% 邀请金。
好友获得
Ɍ5 + 20%
新用户七天累计优惠
好友最低可充 US$1；首次单笔满 US$10 得 Ɍ5，首充后 7 天内累计满 US$20 再得 20%，最高 Ɍ40，两项叠加。
HOW IT WORKS
四步获得并提现邀请金
- 01分享邀请链接
- 02好友注册并充值
- 03获得 USDT 邀请金
- 04提交提现申请
INVITED USERS
邀请记录
USDT WITHDRAWAL
提取已结算的邀请金。
MANUAL REVIEW人工审核
NEW REQUEST
提交提现申请
当前可提现0.00 USDT
WITHDRAWALS
提现记录
i
验证账户可使用 3 次 Luna 受限试用；试用不支持工具调用、长上下文或会话续接。
RESPONSE等待请求
输入 —输出 —总计 —
选择模型并输入提示词，然后发送测试请求。
i
新建的 Key 可随时在此查看和复制；旧 Key 若未保存，请新建一个 Key。
名称 / 前缀使用量 / 限额有效期状态
总额度—
已结算—
处理中—
剩余—
时间模型 / 端点输入输出费用状态
连接 Codex Desktop
推荐使用 Codexy Windows 客户端自动安装和配置；也可以手动写入 Codex 配置文件。
开始前准备确保电脑已安装 Codex Desktop，并注册 Codexy 账户。一键接入由 App 自动创建并加密保存专用凭据，无需手动创建、复制或粘贴 API Key。免费注册 →
推荐
方式一：Codexy App 一键接入
适合 Windows 用户。App 会自动创建专用连接、加密保存凭据、备份原配置并切换 Provider。
- 1下载安装 Codexy下载最新版安装包并完成安装；旧版本会由安装程序自动替换。
- 2登录 Codexy 账户在 App 中输入注册邮箱和密码，进入账户首页。
- 3点击「连接 Codexy」App 自动完成专用凭据和 Codex 配置，无需复制或粘贴 API Key。完成后重启 Codex，模型直接在 Codex 内选择。
一键接入不会覆盖你的原配置：App 会先自动备份
下载 Windows 客户端 v1.8.43
~/.codex/config.toml，需要时可点击「切换回官方」恢复 OpenAI Provider。手动
方式二：手动配置 Codex Desktop
已安装 Codex Desktop，或希望自行管理配置文件时使用。
Windows PowerShell
PowerShell
New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null @' model_provider = "codexy" model = "gpt-5.6-sol" model_reasoning_effort = "high" [model_providers.codexy] name = "Codexy" base_url = "https://codexy.me/v1" env_key = "OPENAI_API_KEY" wire_api = "responses" '@ | Set-Content -Path "$HOME\.codex\config.toml" -Encoding UTF8
macOS / Linux
Terminal
mkdir -p ~/.codex && cat > ~/.codex/config.toml <<'EOF' model_provider = "codexy" model = "gpt-5.6-sol" model_reasoning_effort = "high" [model_providers.codexy] name = "Codexy" base_url = "https://codexy.me/v1" env_key = "OPENAI_API_KEY" wire_api = "responses" EOF
设置 API Key
Windows
PowerShell
[Environment]::SetEnvironmentVariable( "OPENAI_API_KEY", "sk-relay-your-key", "User" )
macOS / Linux
Terminal
echo 'export OPENAI_API_KEY="sk-relay-your-key"' >> ~/.zshrc source ~/.zshrc
完成后请彻底退出 Codex Desktop 再重新打开，使新的环境变量和配置生效。
连接 Codex CLI
先安装 OpenAI Codex CLI，再把模型提供商指向 Codexy。已经安装的用户可直接从第 2 步开始。
01
安装 Codex CLI
需要 Node.js 22 或更高版本。
Terminal / PowerShell
node --version npm install -g @openai/codex codex --version
02
配置 Codexy Provider
将下面内容保存为 ~/.codex/config.toml；Windows 对应 $HOME\.codex\config.toml。
config.toml
model_provider = "codexy" model = "gpt-5.6-sol" model_reasoning_effort = "high" [model_providers.codexy] name = "Codexy" base_url = "https://codexy.me/v1" env_key = "OPENAI_API_KEY" wire_api = "responses"
03
设置密钥并启动
将占位内容替换为控制台生成的真实 API Key。
Windows PowerShell
PowerShell
$env:OPENAI_API_KEY="sk-relay-your-key" codex
macOS / Linux
Terminal
export OPENAI_API_KEY="sk-relay-your-key" codex
验证成功Codex 启动后输入一条简单任务。如果控制台「用量账单」出现新的请求记录，说明接入完成。查看用量 →
API 与 OpenAI SDK
Codexy 兼容 OpenAI Responses 与 Chat Completions 接口。Base URL 固定为 https://codexy.me/v1。
Python
OpenAI SDK
安装官方 SDK 后替换 API Key 即可。
example.py
from openai import OpenAI
client = OpenAI(
api_key="sk-relay-your-key",
base_url="https://codexy.me/v1",
)
response = client.responses.create(
model="gpt-5.6-sol",
input="Confirm in one sentence that the API is connected.",
)
print(response.output_text)cURL
Responses API
适合快速检查密钥、网络和模型是否可用。
Terminal
curl https://codexy.me/v1/responses \
-H "Authorization: Bearer sk-relay-your-key" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-5.6-sol","input":"Hello"}'Video
对话内自动生成视频
Astra、Sol、Terra、Luna 等模型均可将明确的视频生成需求调度至 MiniMax。
Terminal
curl https://codexy.me/v1/responses \
-H "Authorization: Bearer sk-relay-your-key" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-6-astra","input":"帮我生成一段 6 秒 768p 的城市夜景视频"}'返回结果包含视频任务 ID、查询地址和内容地址。普通问答、教程和 API 说明不会误触发生成。
Base URL
https://codexy.me/v1认证方式
Authorization: Bearer API_KEY推荐接口
POST /v1/responses常见问题与排查
按顺序检查密钥、配置文件、环境变量和客户端进程，通常可以快速定位问题。
提示 401 或 API Key 无效
确认密钥以 sk-relay- 开头、没有多余空格，并且未过期或被吊销。完整密钥只在创建时显示一次。
修改配置后没有生效
彻底退出 Codex Desktop 或关闭当前终端，再重新打开。Windows 永久环境变量不会自动进入已经运行的进程。
Codex 仍然要求登录 OpenAI
检查 model_provider = "codexy"、wire_api = "responses" 和配置文件路径是否正确，然后重新启动客户端。
请求超时或没有模型
先检查服务状态与模型目录。模型目录可能随上游账号能力动态变化。