下载即用，一键接入
装好登录后选一个应用点「接入」：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 与请求头
根据使用的模型选择对应的兼容格式：
安装 Gemini CLI（npm / Homebrew）并接入 Aimyria
Gemini CLI 是 Google 出品的开源 AI 编程 CLI（gemini 命令）。
一、从零安装 Gemini CLI
已安装 Gemini CLI？直接跳到下一节。
macOS 用户通过 Homebrew 安装：
brew install gemini-cli
也可以通过 npm 安装（跨平台通用）：
npm install -g @google/gemini-cli
Windows 用户推荐 npm 方式（需先装 Node.js）。
二、获取 Aimyria API Key
访问 Aimyria 控制台 注册账号并创建一个 API Key（格式为 sk-...），复制备用。完整可用模型列表也在 Dashboard 里查看。
三、接入 Aimyria
把下面命令中的 <你的-Aimyria-key> 替换成你刚复制的 key，整段粘贴到终端执行：
mkdir -p ~/.gemini && cat > ~/.gemini/.env <<'EOF'
GOOGLE_GEMINI_BASE_URL=https://aimyria.com
GEMINI_API_KEY=sk-<你的-Aimyria-key>
GEMINI_API_KEY_AUTH_MECHANISM=bearer
EOF
保存后无需重启终端或 source，下一次执行 gemini 命令即生效。跑 gemini 命令时会出现「Get started」引导页，问你 「How would you like to authenticate for this project?」，提供三个选项：
- Sign in with Google
- Use Gemini API Key ← 必须选这个
- Vertex AI
按键盘 ↓ 键移动到 「Use Gemini API Key」，按 Enter 确认。此时Gemini会自动读取你已经配置好的Aimyria API Key，按 Enter 确认即可进入正常使用。
如果此前已经选了 OAuth 模式登录，执行下面命令重置：
rm ~/.gemini/settings.json
删除后下次启动 gemini 会重新跑认证向导，再选 「Use Gemini API Key」 即可。