Aimyria One · 桌面客户端

下载即用,一键接入

装好登录后选一个应用点「接入」:Codex、Claude Code、Gemini CLI、Cherry Studio 全部自动配置完成,不用手改任何配置文件。

支持 Windows;macOS 即将上线。安装包来自 aimyria.com 官方域名。

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 命令行(npm / Homebrew)并接入 Aimyria

Codex 是 OpenAI 官方推出的运行在终端中的 AI 编程助手。先完成第一节安装,再按第二节接入 Aimyria;已安装 Codex 的用户可直接从第二节开始。

一、安装 Codex

  • 推荐安装 Node.js 22+(或使用 Homebrew / 官方 installer)。

  • macOS 用户也可以直接使用 Homebrew 安装:brew install codex。
  • 在命令行界面,执行以下命令安装 Codex:
bash
npm install -g @openai/codex
  • 安装结束后,执行以下命令,若显示版本号则安装成功:
bash
codex --version

二、接入 Aimyria

配置 Provider

macOS / Linux 用户

打开终端,把下面整段粘进去回车:

bash
mkdir -p ~/.codex && cat > ~/.codex/config.toml <<'EOF'
model_provider = "aimyria"
model = "gpt-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」),把下面整段粘进去回车:

bash
New-Item -ItemType Directory -Force -Path "$HOME\.codex" | Out-Null
@'
model_provider = "aimyria"
model = "gpt-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 用户

bash
echo 'export OPENAI_API_KEY="<你的-Aimyria-key>"' >> ~/.zshrc
source ~/.zshrc

Linux 用户

bash
echo 'export OPENAI_API_KEY="<你的-Aimyria-key>"' >> ~/.bashrc
source ~/.bashrc

Windows 用户

bash
[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "<你的-Aimyria-key>", "User")

Windows 用户:执行完上面命令后,关闭当前 PowerShell 窗口重新打开一次才能生效。

两步都做完后,在终端执行 codex 就会走 Aimyria。

三、开启快速模式(可选)

快速模式(Fast mode)可以让 GPT 系列模型输出更快(gpt-5.6-sol 最高可达标准速度的 2.5 倍),按标准价 2 倍计费。

临时开启:在 Codex 会话内输入:

bash
/fast

(/fast 是开关命令,再输入一次即关闭。)

长期开启:在 ~/.codex/config.toml 顶部加一行:

toml
service_tier = "fast"

之后该配置下的请求都会走快速模式。

准备好了?三步即可开始登录控制台 · 购买额度 · 创建 API Key