MATCHALL API / QUICK START

从这里，开始使用。

1. 登录并确认账户

点击“登录后台”，输入你的管理员密码。进入“账户管理”，确认 Pro / Plus 已授权且模型已同步。已有授权无需因更换域名重新连接。

首次连接或需要重新授权时，在自己的电脑运行项目中的 deploy/Open-Authorization.ps1，再通过后台的官方登录按钮完成授权。

2. 创建 API Key

进入“API Keys”→“创建 API Key”，填写应用名称并选择访问范围。模型客户端选择“模型接口”，编程任务选择“编程任务”。完整密钥只显示一次，保存后填入对应应用。

3. 填入客户端配置

配置项	填写内容
接口类型	OpenAI 兼容
Base URL	`https://api.maximoraverse.org/v1`
API Key	你在后台创建的 MatchAll 密钥
模型	`matchall-auto`（按后台策略选择）

https://api.maximoraverse.org/v1

也可使用 matchall-pro / matchall-plus 指定账户，或从 GET /v1/models 返回的列表选择真实模型。客户端会自动补上接口路径时，不要重复填写 /v1。

4. 查看用量，设置限额

进入“用量与限额” →，按时间、密钥、账户、模型或接口筛选，查看请求数、输入 / 输出 Tokens、缓存和花费趋势。

点击“设置限额”设置全局预算，或在对应 API Key 下点击“编辑”。可按每日、每月或累计设置请求数、Tokens 和 USD 限额；留空表示不限，填 0 会阻止新调用。全局与密钥限额同时生效，每日 / 每月按北京时间重置。

USD 是按官方 API 价格估算的等价花费，订阅调用不会因此额外扣费。未上报用量或未定价的数据会标注；已开始的请求会完成，单次实际用量可能使 Tokens / USD 超过设定值。

第一次请求

下面的示例使用 Chat Completions。把占位符替换成自己的密钥：

curl https://api.maximoraverse.org/v1/chat/completions \
  -H "Authorization: Bearer YOUR_MATCHALL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"matchall-auto","messages":[{"role":"user","content":"你好"}],"stream":true}'

多轮对话请发送完整历史。需要固定账户时，增加 X-Matchall-Session: 会话标识 请求头。Responses 客户端也可以使用 POST /v1/responses。

提交编程任务

在“编程任务”中点击“新建任务”，选择 Codex 或 Claude Code，填写说明并上传工作文件。提交后查看进度，完成后点击文件名称下载结果；执行中的任务可取消。

Claude Code 需要先按“账户管理”中的步骤独立登录。Claude 订阅用于编程任务；通用 /v1/messages 接口需要在“接入与设置”中另行配置官方 Anthropic API Key。

遇到问题时

401：检查 API Key 是否填写正确、是否已撤销。
429：可能达到服务限额、账户用量受限或正在排队。在“请求记录”中查看原因；若达到自设限额，在“用量与限额”中查看重置时间或调整预算。
没有可用账户：在“账户管理”中检查授权、启用状态和冷却情况。

自动切换只发生在输出开始前。后台 Tokens 是本服务记录，实际剩余额度以官方账户用量页面为准。

进入工作台 →返回首页