API 接入

MAIRouter 的模型调用接口兼容常见 OpenAI 客户端。可用模型 ID 和能力以控制台为准，不要从公开站硬编码模型列表。API Base URL 是 https://llmstore.mairouter.cn/v1。

准备信息

在控制台完成以下操作：

确认当前组织，完成本人的个人认证，并确认组织钱包已就绪且有足够余额。
从“模型广场”确认目标模型 ID 和支持的端点类型。
使用 API Base URL https://llmstore.mairouter.cn/v1。
在本人权限范围内创建仅具备所需模型、额度和 IP 范围的 Key。

企业认证不是创建 Key 或调用模型的前提，也不能代替本人认证。Key 列表始终显示掩码；需要时可以单独查看或复制完整 Key。建议仍将 Key 存入服务端密钥管理系统。

Key 及其消费归属创建时的组织。组织改名、成员离开或加入新组织都不会转移原 Key、余额或历史用量；退出不会新建组织或钱包。加入其他组织后，需按目标组织的权限使用或创建该组织的 Key，不能沿用原组织的 Key 或余额。

Chat Completions 示例

选择支持 Chat Completions 的模型，并替换 Key 和模型 ID 占位符。以下请求可能产生模型调用费用。环境变量名称与控制台接入指南一致。

macOS / Linux

export OPENAI_BASE_URL="https://llmstore.mairouter.cn/v1"
export OPENAI_API_KEY="replace-with-your-key"
export OPENAI_MODEL_ID="replace-with-a-console-model-id"

curl "$OPENAI_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "'"$OPENAI_MODEL_ID"'",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": false
  }'

Windows PowerShell

$env:OPENAI_BASE_URL = 'https://llmstore.mairouter.cn/v1'
$env:OPENAI_API_KEY = 'replace-with-your-key'
$env:OPENAI_MODEL_ID = 'replace-with-a-console-model-id'

$body = @{
  model = $env:OPENAI_MODEL_ID
  messages = @(@{ role = 'user'; content = '你好' })
  stream = $false
} | ConvertTo-Json -Depth 5

Invoke-RestMethod -Method Post `
  -Uri "$env:OPENAI_BASE_URL/chat/completions" `
  -Headers @{ Authorization = "Bearer $env:OPENAI_API_KEY" } `
  -ContentType 'application/json; charset=utf-8' `
  -Body ([System.Text.Encoding]::UTF8.GetBytes($body))

只想验证连接时，可在控制台“接入指南”中复制 /models 查询示例；它不发送生成请求。查询成功不保证实际生成一定可用，生成仍受余额、预算、模型能力和 Key 限制影响。

认证头

模型请求使用：

Authorization: Bearer YOUR_API_KEY

网页的手机号登录状态不能替代模型调用 API Key。不要向浏览器公开服务端 Key。

Key 限制

创建或编辑 Key 时可以限制：

有效期；
可用人民币额度或无限额度；
可调用模型；
允许的来源 IP；
网关分组（以当前账户表单提供的选项为准）。

停用和删除命令会提交到网关。若显示处理中或待人工核对，请先刷新并核对原操作结果，不要重复创建 Key。

核对用量

“使用记录”默认展示本月计费明细，可按 Key、模型和日期等条件筛选。日期按北京时间计算，自定义范围最长 366 天，结束日期不包含在查询范围内；实际可查数据仍取决于采集覆盖范围和账户权限。

金额口径以页面说明为准：平台会按账务口径将费用统一展示为人民币。金额未知或历史覆盖不完整不代表零消费。输入、输出和缓存 Token 分别展示，以返回数据为准。

首次调用后尚无记录时，先核对月份、Key 和其他筛选条件，再点击“刷新数据”。在“数据说明”查看最近成功同步时间与覆盖情况；刷新页面不会强制上游立即完成采集。

调用失败时排查

先查看响应中的错误信息和请求 ID（若有）。HTTP 状态只提供线索，不代表唯一原因，具体以网关响应为准。

现象	下一步
连接失败或找不到接口	核对 Base URL 是否以 `/v1` 结尾，避免重复拼接 `/v1`；确认网络和端点路径。
鉴权或访问被拒绝	确认发送的是完整 API Key、没有多余空格；检查本人的个人认证、组织成员状态，以及 Key 的启用状态、有效期、IP 和模型限制，查看“调用状态”的具体说明。
模型或端点不支持	从控制台复制准确模型 ID，并核对该模型支持的端点；模型名称不一定等于请求中的 ID。
额度、余额或预算不足	核对 Key 额度、组织余额及部门预算；需要时联系组织管理员。
限流、超时或服务暂不可用	根据错误说明及重试提示降低并发、稍后重试；对结果不明确的生成请求不要连续重发，以免重复调用。

联系支持时提供发生时间、模型 ID、HTTP 状态、请求 ID 和脱敏后的错误信息。不要发送完整 Key、Authorization 请求头或包含敏感内容的完整请求体。