常见问题

API 地址是什么？

https://api.monoai.today

OpenAI 兼容客户端使用：

https://api.monoai.today/v1

如何获取模型 ID？

打开模型广场，或调用：

curl https://api.monoai.today/v1/models \
  -H "Authorization: Bearer $MONOIZE_API_KEY"

为什么请求返回 401？

常见原因：

• 请求头中没有 API Key。
• 密钥拼写错误或已被删除。
• 密钥已过期。

处理方式：在控制台检查密钥状态，或创建新密钥。

为什么请求返回 404？

模型 ID 不存在或当前不可用。请重新调用 /v1/models 获取最新列表。

为什么模型广场显示的价格与实际不同？

模型广场显示的是按分组计算的参考价格。实际结算以控制台记录为准。

支持哪些协议？

• OpenAI Chat Completions
• OpenAI Responses
• Anthropic Messages
• Embeddings
• 图像生成与编辑

详见 API 总览。

可以同时在多个客户端使用吗？

可以。同一个 API Key 可以用于多个客户端。为了安全，也可以为每个客户端创建单独的密钥。

如何查看用量？

登录控制台，在 用量 查看调用记录和消耗统计，在 账单 查看收支和订单，在 购买 获取额度。

地址是否需要包含 /v1？

OpenAI SDK 的 Base URL 使用 https://api.monoai.today/v1。 Anthropic SDK 使用 https://api.monoai.today，不要添加 /v1。 完整请求地址还包含 /chat/completions、/responses 或 /messages，不要将其填入 SDK Base URL。 控制台的接入示例区分这两类地址，并支持复制。

模型名怎么写？

复制模型广场中的完整模型 ID，保留大小写和前缀。 不要使用显示名称代替 ID。 目录可见不保证当前分组可调用，以调用记录中的结果为准。

已付款但未到账怎么办？

打开 账单 查看订单状态；支持查询的渠道可以使用 查询状态。 支付页面返回成功不等于服务端已确认到账。 如果持续未到账，向管理员提供订单 ID、支付时间和实付金额。 详见购买与账单。

余额充足，为什么调用仍然失败？

• API Key 累计消费可能已达到自身限额，余额不能解除这个限额。
• Coding Plan 的任一窗口额度可能已耗尽。
• Coding Plan 的分组、API Key 分组或模型权限可能不允许该模型。
• IP 白名单可能不包含当前客户端地址。

检查返回的错误码以及 error.param。 详见错误与状态码和调用记录。