下载即用，一键接入
装好登录后选一个应用点「接入」：Codex、Claude Code、Gemini CLI、Cherry Studio 全部自动配置完成，不用手改任何配置文件。
Aimyria API 接入文档
Aimyria 支持 OpenAI、Google Gemini、Anthropic 多种兼容格式接口。你可以把官方 SDK 的 base URL 指向 Aimyria，无需改动业务代码，即可调用 Claude / Gemini / GPT 等多家模型。
- Base URL：
https://aimyria.com - 鉴权：API Key（
sk-...） - 协议：同时支持 Anthropic 原生格式（
/v1/messages）、OpenAI 兼容格式（/v1/chat/completions）、OpenAI Responses API（/v1/responses，仅 GPT 系列）、Gemini 原生格式（/v1beta/models/{model}:generateContent）和图像生成（/v1/images）
新账号余额为 0，先充值再调用。 第一次请求前先充值。如果请求返回 402（OpenAI 格式为 400）、提示「钱包余额不足」，说明余额为 0，不是 Base URL 或 Key 配错了，充值后重试即可。
文中的 sk-xxxxxx 请替换为你自己的 Key，妥善保管、不要提交到代码仓库。
没有海外卡？也可以用 USDT 充值：在充值弹窗点「Crypto支付」，用 USDT、USDC 或 ETH，从币安、OKX 等交易所 App 转账即可——收银台会按金额显示可用网络，不用装钱包插件（教程）。
一、Base URL 与请求头
根据使用的模型选择对应的兼容格式：
安装 Codex 客户端并接入 Aimyria
Codex 客户端（Codex Desktop）是 OpenAI 官方推出的桌面端 AI 编程助手。
Codex 客户端（Codex Desktop）是 OpenAI 官方推出的桌面端 AI 编程助手。按本文步骤安装 Codex 客户端并修改配置文件，即可接入 Aimyria。
没有海外卡？也可以用 USDT 充值：在充值弹窗点「Crypto支付」，用 USDT、USDC 或 ETH，从币安、OKX 等交易所 App 转账即可——收银台会按金额显示可用网络，不用装钱包插件（教程）。
方式一：Aimyria One 客户端一键接入（推荐）
Aimyria One 客户端是 Aimyria 的官方桌面客户端，可以傻瓜式完成Codex客户端的下载、免订阅Aimyria接入、模型配置等流程，真正做到5分钟开箱即用，免去用户自己摸索和试错的烦恼。
【下载 Windows 版】 【】
TIP：下载安装过程中，如遇系统误报风险提示，请选择信任或继续。
安装完成后，如图所示，请完成账号注册。
进入客户端后，找到 Codex客户端 进行下载&安装（或自行从OpenAI官网下载）。
而后，点击“连接Aimyria”按钮，，您会看到选择模型的弹窗，在此选择您需要接入的模型即可。如需在Codex中接入Kimi K3模型，在此选择后接入即可。
客户端会自动将您本机的Codex客户端，与Aimyria完成连接&配置。
若您需要切换回OpenAI官方订阅套餐，可点击“断开 Aimyria”按钮，即可断开Codex客户端与Aimyria的连接。
点击确认接入后，点击打开应用，就可以正常开始使用Codex了。
您可以在Aimyria的控制台，看到每条请求的用量情况。
方式二：手动配置（不推荐）
如您不想使用Aimyria One 客户端，也可参考本章手动进行Codex安装&Aimyria接入。
手动下载 Codex
下载 Codex 客户端
如果您已安装 Codex 客户端，可跳过本章。
- 根据你的系统选择对应的安装包下载：
- macOS（Apple Silicon，M 系列芯片）：Codex.dmg
- macOS（Intel 芯片）：Codex-latest-x64.dmg
- Windows：Microsoft Store 安装
- 下载后双击安装包，按提示完成安装。Linux 用户暂时只能使用 CLI 版本（参考 Aimyria 接入 Codex）。
修改系统配置文件
macOS / Linux 用户
打开终端，把下面整段粘进去回车：
mkdir -p ~/.codex && cat > ~/.codex/config.toml <<'EOF'
model_provider = "aimyria"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
[model_providers.aimyria]
name = "Aimyria"
base_url = "https://aimyria.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
EOF
Windows 用户
打开 PowerShell（开始菜单搜「PowerShell」），把下面整段粘进去回车：
New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null
@'
model_provider = "aimyria"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
[model_providers.aimyria]
name = "Aimyria"
base_url = "https://aimyria.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
'@ | Set-Content -Path "$HOME\.codex\config.toml" -Encoding UTF8
设置 API Key
把下面命令里的 <你的-Aimyria-key> 替换成你自己创建的 API Key，API Key 在 Aimyria 控制台 获取。然后粘到终端执行。
macOS 用户
echo 'export OPENAI_API_KEY="你的-Aimyria-key"' >> ~/.zshrc
source ~/.zshrc
Linux 用户
echo 'export OPENAI_API_KEY="你的-Aimyria-key"' >> ~/.bashrc
source ~/.bashrc
Windows 用户
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "你的-Aimyria-key", "User")
Windows 用户：执行完上面命令后，关闭 Codex 桌面版重新打开一次才能读到新的环境变量。
启动 Codex 桌面版
打开Codex桌面版应用，如果之前已经打开过。请关闭后重新打开。
您可以在Aimyria的控制台，看到每条请求的用量情况。