用 一个 API Key 调用主流 AI 模型

1平台概览

MIAOHA 是一个统一接入多家模型提供方的 AI API 网关，你可以用同一个 sk- 风格的 API Key 访问下面这些模型：

所有接口统一使用 OpenAI Chat 兼容协议（/v1/chat/completions）和 Anthropic Messages 协议（/v1/messages）。

2快速开始

按以下四步，五分钟内完成第一次模型调用。

1. 访问 注册页，使用邮箱创建账号并通过邮件验证码完成验证。
2. 登录后进入 API Key 管理，点击"创建 Key"，为 Key 选择分组与有效期。
3. 在客户端中配置 Base URL：https://aiapi.miaoha.xyz/v1，使用 sk- 开头的 API Key 作为鉴权头。
4. 复制下方任一示例直接运行：

OpenAI 风格调用（流式）

# 流式（推荐，支持长文本与流式 UI）
curl -N https://aiapi.miaoha.xyz/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role": "user", "content": "用一句话介绍 MIAOHA"}],
    "stream": true
  }'

Anthropic 风格调用

curl https://aiapi.miaoha.xyz/v1/messages \
  -H "x-api-key: sk-YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "你好，介绍下你自己"}]
  }'

3注册与登录

注册流程

平台使用邮箱注册 + 邮件验证码验证：

1. 填写邮箱与密码（建议至少 12 位、含大小写与数字），点击"获取验证码"。
2. 登录邮箱，复制 6 位验证码，填写后提交。
3. 邮箱验证后即登录成功，JWT 会话 24 小时有效。

登录与会话

通过邮箱与密码登录后获取 JWT，后续接口在 Authorization: Bearer <token> 请求头中携带即可。会话默认 24 小时，到期后请使用 refresh_token 静默续期。

密码找回

1. 登录页点击"忘记密码"，输入注册邮箱。
2. 查收邮件中的重置链接（链接一次性有效，1 小时内有效）。
3. 链接中已包含 token 参数，在打开的页面里设置新密码即可。

4API Key 管理

创建与命名

每个账号可创建多个 API Key，建议按项目/环境/角色命名（如 prod-app、dev-eval、ci-bot）。创建后页面只显示完整 Key 一次，请妥善保存。

分组与额度

每个 Key 需绑定一个分组（group），分组决定了可用模型、计费倍率与限速规则。常见分组：

可以在创建 Key 时设置：

• 分组：决定可用模型与价格倍率
• 额度上限（可选）：Key 累计消费上限，触达后自动停止扣费
• 有效期（可选）：到期后 Key 失效，刷新即可
• IP 白名单/黑名单（可选）：限制可调用此 Key 的来源

5接口文档

所有接口使用 https 协议，Base URL：https://aiapi.miaoha.xyz。鉴权使用 Authorization: Bearer sk-...（Anthropic 兼容端点额外需要 x-api-key 头）。

OpenAI 兼容 — /v1/chat/completions

OpenAI Chat Completions 协议，支持 stream:true 服务端推送。

{
  "model": "gpt-5.5",
  "messages": [
    {"role": "system", "content": "你是一个简洁的助手"},
    {"role": "user",   "content": "用 50 字介绍 API 网关"}
  ],
  "stream": true,
  "temperature": 0.7
}

Anthropic 兼容 — /v1/messages

Anthropic Messages 协议，Claude 全系可用。

{
  "model": "claude-sonnet-4-6",
  "max_tokens": 1024,
  "system": "你是一个简洁的助手",
  "messages": [
    {"role": "user", "content": "用 50 字介绍 API 网关"}
  ]
}

获取模型列表 — /v1/models

用你的 Key 调用，返回该 Key 当前可用模型清单：

curl https://aiapi.miaoha.xyz/v1/models \
  -H "Authorization: Bearer sk-YOUR_KEY"

OpenAI Responses — /v1/responses

OpenAI 新版 Responses API（与 Chat 兼容长期共存），用于支持 Responses 工具调用与对话状态。鉴权方式相同。

6模型与价格

当前公开展示的模型按分组列出（专属分组需登录后查看）。价格按输入/输出 Token 计数，部分模型支持分段定价与缓存读写价。

7计费与余额

• 计费方式：按 Token 数量计费，输入与输出分开计算；流式请求已产生部分同样会扣费。
• 余额与充值：进入 购买 或 兑换码 页面充值；兑换码可在 兑换 中粘贴激活。
• 余额不足：请求将返回 402 错误并附带余额信息，请尽快充值或更换余额充足的 Key。
• 按量计费套餐：可订阅 订阅套餐，在套餐有效期内按套餐规则计费。
• 推广奖励：在 推广 页面生成推广链接，邀请新用户获得消费返佣。

8错误码

所有错误响应采用统一 JSON 格式：{"code": "...", "message": "...", "reason": "..."}。常见错误：

9常见问题

Q1：在客户端中如何切换到 MIAOHA？

把 Base URL 改为 https://aiapi.miaoha.xyz/v1，API Key 替换为 MIAOHA 平台创建的 sk- 风格 Key 即可，模型名称可继续用各厂商原名（如 gpt-5.5、claude-sonnet-4-6）。

Q2：可以同时使用多家模型吗？

可以。为不同模型分别创建 Key 或使用同一个 Key（如果该 Key 所在分组支持多家平台）。同一 Key 跨平台请求时，model 字段决定实际路由。

Q3：长上下文如何计费？

部分模型（如 GPT 系列）>272K Token 的请求按更高档位计费，缓存命中价通常更低。具体分段以 模型广场 的档位表为准。

Q4：账户被锁定或 Key 被禁用怎么办？

先确认是否违反使用政策（如滥用、绕过限频等）。如对处理有异议，可通过下方"联系与支持"渠道反馈。

Q5：网页无法打开或调用报跨域错误？

请确保使用 https://（不要写成 http://）。MIAOHA 已为 /v1/ 配置 CORS 头，浏览器端可直接调用。

10联系与支持

• 使用问题与建议：控制台"工单"或"消息"入口
• 商务合作：在控制台"个人资料"查看联系方式
• 服务状态：系统公告会持续发布维护与故障信息