控制台登录

开发者指南

从 API Key 到第一条请求：主流客户端与框架的接入方式、计费口径，以及常见错误排查。

OpenAI 兼容接入

接口地址固定为 https://new.aimyria.com/v1，使用 Bearer 鉴权：

bash
curl https://new.aimyria.com/v1/models \
  -H "Authorization: Bearer $AIMYRIA_API_KEY"

聊天补全用 /v1/chat/completions。模型名以 模型广场 为准。

支持的端点

POST /v1/chat/completions对话补全
POST /v1/messagesAnthropic 协议对话
GET /v1/models当前 Key 可用模型
POST /v1/images/generations图像生成

Anthropic 协议

Claude 系模型走 Anthropic 协议，根地址不带 /v1：

env
ANTHROPIC_BASE_URL=https://new.aimyria.com
ANTHROPIC_AUTH_TOKEN=你的Key

Claude Code

设置环境变量后直接启动 claude：

bash
export ANTHROPIC_BASE_URL=https://new.aimyria.com
export ANTHROPIC_AUTH_TOKEN=你的Key
claude
提示如需按项目切换，可写进项目的 .env 或 shell profile；不要把 Key 提交进 Git。

Cursor

打开 Settings → Models，添加 OpenAI API Key；在 Override OpenAI Base URL 填入：

Base URL
https://new.aimyria.com/v1

然后在模型列表里手动添加要用的模型名，关闭不需要的模型，避免 Cursor 自动选用未开通的模型。

Cherry Studio

设置 → 模型服务 → 添加 OpenAI 兼容服务商：

  • API 地址：https://new.aimyria.com/v1
  • API Key：控制台创建的 Key
  • 模型：按模型广场名称添加

Dify

设置 → 模型供应商 → OpenAI-API-compatible：

  • Base URL：https://new.aimyria.com/v1
  • API Key：控制台创建的 Key
  • Model Name：填写模型广场中的完整模型名

计费与用量

按实际调用消耗计费，价格单位是 USD / 1M tokens，输入与输出分别计价。

举例：某模型输入 $0.045、输出 $0.18 每百万 tokens，一次调用用掉 10K 输入加 2K 输出，费用约为 0.045 × 0.01 + 0.18 × 0.002，约 $0.00081。

用量与余额在 控制台 实时查看。余额不足会返回 429。

注意生图类模型按张计价，不在 tokens 计价体系内。

错误排查

401
Unauthorized

Key 无效、被停用，或请求没带 Authorization: Bearer。到控制台检查 Key 状态。

404
Not Found

baseURL 写错。OpenAI 兼容用 /v1；Anthropic 协议用根地址。

429
Rate Limited / 余额不足

触发限流或余额不足。稍后重试或在控制台充值。

503
No Available Channel

该分组暂无可用通道。换一个分组或稍后重试，长期出现请提工单。