令牌使用说明

API Key 用于鉴权、计费和权限控制。创建后把 AveMujicaAPI API Key 填到 Codex、OpenAI-compatible 客户端或图片客户端里。

创建入口

打开登录页，登录 AveMujicaAPI 控制台。
打开令牌管理页面。
点击“添加令牌”。
创建后，在“密钥”列点击复制图标，把 API Key 复制到需要使用的客户端。

页面操作

区域	操作
顶部按钮	添加令牌、复制所选令牌、删除所选令牌、紧凑列表
查询栏	搜索关键字、密钥、查询、重置
密钥列	查看密钥、复制密钥
行操作	聊天、聊天旁边的下拉扩展、禁用、编辑、删除
列表字段	名称、状态、剩余额度/总额度、分组、密钥、可用模型、IP限制、创建时间、最后使用时间、过期时间

“聊天”按钮旁边的下拉扩展可把当前令牌快速导入已有软件。菜单包含 Cherry Studio、AionUI、流畅阅读、CC Switch、Lobe Chat 官方示例、AI as Workspace、AMA 问天、OpenCat。

填到哪里

场景	填法
Codex CLI / Codex App	同一个 API Key，`base_url = "https://api.avemujica.moe/v1"`，`wire_api = "responses"`
OpenAI-compatible 客户端	Provider 选 OpenAI-compatible，Base URL 填 `https://api.avemujica.moe/v1`
控制台导入入口	在令牌行右侧点击“聊天”旁边的下拉扩展，选择目标软件后导入
图片生成或编辑	API Key 不变，模型填 `gpt-image-2`，接口走 Images API
服务端集成	API Key 放在服务端环境变量或密钥管理系统，不要写进前端代码

通用配置速查

配置项	填写方式
Provider	`AveMujicaAPI` 或自定义名称
Base URL	`https://api.avemujica.moe/v1`
API Key	控制台创建的 AveMujicaAPI API Key
文本模型	控制台展示的 GPT/Codex 模型 ID
图片模型	`gpt-image-2`
常见错误	401 / 403 / 429 / model not found / timeout

Key 怎么拆

用法	做法
本机 CLI	一个本机专用 Key，放在 `~/.codex/auth.json` 或客户端配置里
测试脚本	单独创建测试 Key；测试结束后删除或停用
生产服务	单独创建生产 Key，放在服务端密钥管理系统里
团队协作	不共用个人 Key；按成员或项目拆分，便于停用和追踪
临时排查	排查结束后删除或停用临时 Key

安全要求

不要把 API Key 提交到 Git 仓库。
不要把 API Key 发到群聊、截图、工单公开区或日志里。
前端页面、浏览器插件和公开仓库不要直接写入生产 Key。
泄露后立即停用旧 Key，创建新 Key，并检查近期调用记录和余额。
生产环境日志要脱敏，至少隐藏 Key 的中间和尾部内容。

与多工具的关系

Codex：配置 wire_api = "responses"。
Claude Code 兼容工作流：通过支持 OpenAI-compatible provider 的工具或桥接层使用 AveMujicaAPI；不要把 AveMujicaAPI 当作原生 Anthropic 端点。
Gemini/Cline 等兼容客户端：选择 OpenAI-compatible provider，填写 GPT 模型 ID。
图片客户端：选择 OpenAI-compatible Images API，模型填写 gpt-image-2。

最小验证

先验证 Key 是否能列出模型：

bash

curl "https://api.avemujica.moe/v1/models" \
  -H "Authorization: Bearer <YOUR_AVEMUJICA_API_KEY>"

能拿到模型列表后，再发一次最小文本请求：

bash

curl "https://api.avemujica.moe/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_AVEMUJICA_API_KEY>" \
  -d '{
    "model": "<MODEL_ID_FROM_CONSOLE>",
    "messages": [
      {"role": "user", "content": "回复：Key 已可用"}
    ]
  }'

看控制台显示

令牌能力、模型范围、费用和限制以控制台展示为准。实验能力会在控制台标记可用工具、计费方式和使用限制。

令牌使用说明 ​

创建入口 ​

页面操作 ​

填到哪里 ​

通用配置速查 ​

Key 怎么拆 ​

安全要求 ​

与多工具的关系 ​

最小验证 ​

看控制台显示 ​