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 与请求头
根据使用的模型选择对应的兼容格式:
安装 OpenCode 并接入 Aimyria
OpenCode 是一个开源 AI 编程助手,提供终端、网页等运行形式。
一、接入 Aimyria
如果你已经安装了 OpenCode Desktop,按以下步骤添加 Aimyria:
- 打开 OpenCode Desktop,点击左下角齿轮 ⚙ 图标进入设置。

- 在左侧导航选择 「服务器」→「提供商」。
- 在右侧提供商列表底部找到 「自定义提供商」(带「自定义」标签,说明文案为「通过基础 URL 添加与 OpenAI 兼容的提供商。」),点击右侧 「+ 连接」 按钮。

-
在「自定义提供商」表单中填入:
- 「提供商 ID」:
aimyria - 「显示名称」:
Aimyria - 「基础 URL」:
https://aimyria.com/v1 - 「API 密钥」:粘贴你在 Aimyria 控制台 创建的 key
- 「提供商 ID」:
-
在「模型」字段点击 「+ 添加模型」 添加要使用的模型,按需填入 model id 与显示名称:
| Model ID | 模型名称 |
|---|---|
| gpt-6.1-sol | GPT 6.1 Sol |
| gpt-6.1-terra | GPT 6.1 Terra |
| gpt-6-astra | GPT 6 Astra |
| gpt-6-sol | GPT 6 Sol |
| gpt-6-luna | GPT 6 Luna |
| gpt-5.6-sol | GPT 5.6 sol |
| gpt-5.6-terra | GPT 5.6 terra |
| gpt-5.6-luna | GPT 5.6 luna |
| claude-opus-5-5 | Claude Opus 5.5 |
| claude-sonnet-5-5 | Claude Sonnet 5.5 |
| claude-haiku-5-5 | Claude Haiku 5.5 |
| claude-fable-5-1 | Claude fable 5.1 |
| claude-fable-5 | Claude fable 5 |
| claude-sonnet-5 | Claude sonnet 5 |
| claude-opus-4-8 | Claude opus 4.8 |
| claude-opus-4-7 | Claude opus 4.7 |
| claude-opus-4-6 | Claude opus 4.6 |
| claude-sonnet-4-6 | Claude sonnet 4.6 |
| claude-haiku-4-5 | Claude haiku 4.5 |
| gpt-5.5 | GPT 5.5 |
| gpt-5.4 | GPT 5.4 |
| gemini-4-argon | Gemini 4 Argon |
| gemini-3.1-pro-preview | Gemini 3.1 pro(preview) |
| gemini-3.8-flash | Gemini 3.8 Flash |
| deepseek-flash | DeepSeek V4.1 Flash |
| deepseek-v4-pro | DeepSeek v4 pro |
| deepseek-v4-flash | DeepSeek v4 flash |
| deepseek-v4-flash-free | DeepSeek V4 Flash 福利版 |
| glm-5.3-flash | GLM 5.3 Flash |
| glm-5.3 | GLM 5.3 |
| glm-5.2 | GLM 5.2 |
| grok-4.7 | Grok 4.7 |
| grok-4.6 | Grok 4.6 |
| kimi-k3.1-pro | Kimi K3.1 Pro |
- 「请求头(可选)」无需填写。
- 点击底部 「提交」 按钮保存。
注意:受OpenCode客户端自身限制,自定义提供商仅支持 OpenAI 协议,会导致 Claude 系列的模型调用会出现 cache 丢失、调用失败等问题,造成不必要的金额损耗。因此不建议在OpenCode内使用 Claude 系列模型,如有 Claude 系列模型使用需要,建议使用 Claude 客户端。
二、从零安装 OpenCode
下载与安装
前往官方下载页面安装或升级:OpenCode 下载
运行与配置
- 执行
opencode命令
添加 Aimyria 提供商
打开 OpenCode Desktop,按上一节的步骤 1–7 完成配置。
设置模型
在设置页左侧导航选择「服务器 → 模型」,将默认聊天模型切换为 Aimyria 下的模型。之后所有新会话都会默认使用该模型。
开始使用
回到 OpenCode Desktop 主界面新建对话,即可开始对话。
