Skip to content

API Key 管理 ​

在 API management 页面管理你的所有 Key,并查看当前可用的上游渠道。

主 Key 与专用 Key ​

主 Key专用 Key
生成方式注册时自动生成,Dashboard 可见API management 页手动创建
作用范围全部渠道、全部模型可限定余额类型 / 渠道 / 模型
典型用途个人日常使用分场景隔离(如只给 WorkBuddy 用的 gpt-5.4 Key)

创建专用 Key ​

  1. 打开 API management,点击 Create
  2. 依次选择:
    • 余额类型:Pay-as-you-go 或 Subscription
    • 分组(Group):默认 default
    • 提供商(Provider):Any(自动路由)或指定某个渠道
    • 模型(Models):Any 或限定具体模型
  3. 点击创建并立即复制保存 Key

何时需要限定渠道?

部分第三方客户端只兼容特定协议 — 例如 WorkBuddy 必须走 Openai Legacy 渠道(/v1/chat/completions)。为这类场景创建限定渠道的专用 Key,可以避免请求被路由到不兼容的端点。

每个 Key 支持 Edit(调整范围)与 Revoke(吊销),互不影响。

可用渠道与倍率 ​

Available Providers 区域按协议分组展示你当前可用的渠道。每个渠道有一个计费倍率(rate multiplier),实际扣费 = 模型基础价 × 渠道倍率。

以按量(PAYGO)上下文为例(渠道与倍率以站内实时显示为准):

协议渠道示例倍率说明
Anthropic /v1/messagesClaudeMax20_Original1.7×纯 Max20 官方号池,0 注入,缓存 92%+
Claude(Official)2.5×官方渠道(Max 池 / Bedrock / Azure),稳定性最佳
OpenAI /v1/responsesCodex Pro0.6×WSS 支持,Codex CLI 为主,OpenClaw、OpenCode 等可用
GPT-IMAGE-21×图像生成专用
OpenAI /v1/chat/completionsOpenai Legacy(Pro)0.6×兼容传统 Chat Completions 的通用渠道(WorkBuddy、Trae 等)
Gemini /v1betaGenimiHybrid0.8×融合 Anti-gravity 与 Google 订阅,支持 Gemini CLI 及其他 Agent

Claude 渠道不限客户端

2026-08 起所有 Claude 渠道(Max20_Original 与 Official)均已解除客户端限制,Claude Code、VS Code / Cursor 扩展、Claude Desktop、WorkBuddy、Trae 等任意客户端均可使用。

自动渠道切换(故障转移) ​

Automatic provider switching 开关控制故障转移行为:

  • 开启:当状态监控发现某渠道异常时,按你排列的优先级顺序自动降级到下一个渠道
  • 关闭:只使用每组排在 #1 的渠道

优先级支持拖拽排序,按余额类型(PAYGO / TEAM 等)分别配置。

用 API 验证 Key ​

bash
# 个人 Key:查余额
curl https://moacode.org/api/v1/user/balance -H "X-API-Key: 你的APIKey"

# 团队 Key:查团队额度
curl https://moacode.org/api/v1/team/stats/spending -H "X-API-Key: 团队APIKey"

更多平台接口见站内 Docs & news → API documentation(Swagger 可在线调试)。

MoaCode — One key. Every coding agent.