鉴权¶

Macaron 托管模型 API 使用在 dashboard 创建的 API key 鉴权请求。API 客户端没有 email/password 流程——dashboard 登录仅用于 Web UI。

创建 API key¶

在 dashboard 登录：https://mint.macaron.im（中国大陆以外）或 https://mintcn.macaron.xin（中国大陆）。
打开 API Keys 并创建新 key。
立即复制 key。它以 sk- 为前缀，且仅显示一次。

API Keys 列表——每个 key 显示掩码值、消费、状态与创建时间。

创建 key 对话框——key 只需填名称；密钥生成后仅显示一次。

将 key 视为密钥：不要提交到版本控制或暴露在客户端代码中。本文档示例使用占位符 <MACARON_API_KEY>。

使用 key¶

在每个请求的 Authorization 头中以 bearer token 传递 key：

curl https://mint.macaron.im/v1/chat/completions \
  -H "Authorization: Bearer <MACARON_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "macaron-v1-venti",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

对于从环境变量或配置文件读取 key 的 SDK 与工具集成，见集成。

区域端点¶

区域	Base URL
中国大陆以外	`https://mint.macaron.im`
中国大陆	`https://mintcn.macaron.xin`

使用离用户最近的端点。两者服务相同模型阵容并接受相同 API key。

Key 管理¶

key 绑定到你的账户。若泄露，在 dashboard 轮换。
用量与计费按 key 在 dashboard 跟踪；见用量。
dashboard 报告账户的速率限制（RPM）与并发配额。