API 协议总览
MoaCode 的统一 Base URL 为 https://moacode.org，同时支持三种主流 API 协议。请求会按你的 Key 范围与渠道优先级自动路由到健康的上游。
协议对照表
| 协议 | 端点 | 认证方式 | 兼容 SDK / 客户端 |
|---|---|---|---|
| Anthropic Messages | POST /v1/messages | x-api-key 或 Authorization: Bearer | Anthropic SDK（Python / TS）、Claude Code |
| OpenAI Responses | POST /v1/responses | Authorization: Bearer | OpenAI SDK、Codex CLI、OpenClaw |
| OpenAI Chat Completions | POST /v1/chat/completions | Authorization: Bearer | OpenAI SDK、WorkBuddy、Trae 等通用客户端 |
| Gemini | POST /gemini/v1beta/... | x-goog-api-key | Gemini CLI、Google SDK、Nano Banana 生图 |
协议与渠道要匹配
每个协议背后是不同的渠道组（例如 Chat Completions 由 Openai Legacy 渠道服务）。用专用 Key 限定了渠道时，请确认调用端点与渠道协议一致，否则会报错。
认证
所有协议都用你的 MoaCode Key（cr_ 开头）：
bash
# Anthropic 风格
-H "x-api-key: cr_xxxx"
# OpenAI 风格
-H "Authorization: Bearer cr_xxxx"流式输出
三种协议均支持 "stream": true 的 SSE 流式响应，用法与各官方 API 一致。
平台 API（账户查询）
除模型调用外，还有一组平台管理接口（Base URL：https://moacode.org/api/v1，认证用 X-API-Key 头）：
| 接口 | 说明 |
|---|---|
GET /api/v1/user/balance | 查询个人余额 |
GET /api/v1/user/usage | 用量明细（分页） |
GET /api/v1/user/usage/summary | 按模型汇总的用量统计 |
GET /api/v1/team/stats/spending | 团队额度与消费（团队 Key） |
GET /api/v1/team/stats/usage | 团队用量统计（团队 Key） |
GET /api/v1/public/models | 公开模型目录（含价格，无需认证） |
bash
curl https://moacode.org/api/v1/user/balance -H "X-API-Key: 你的APIKey"完整平台接口（Swagger 在线调试）见站内 Docs & news → API documentation。
分协议详解
- Anthropic Messages — Claude 模型，Python / TypeScript / cURL 示例
- OpenAI 协议 — Responses 与 Chat Completions，GPT 模型
- GPT 生图接口 — gpt-image-2 两种调用方式
- 模型目录与价格