API 接入指南 - 小月神 API

1. 创建并保存 API Key

登录控制台，在 API 密钥页面创建供应用使用的 API Key。检查密钥的状态、有效期、额度以及关联分组；不同分组可见的模型和计费规则可能不同。

将密钥保存在服务端环境变量或密钥管理服务中。浏览器公开代码、公开仓库和共享截图中不应包含完整密钥。

以本站控制台或管理员提供的 API 地址为准。客户端中的 Base URL、服务地址和接口地址可能含义不同，请先确认客户端是否自动拼接 API 路径。

例如，兼容客户端要求 Base URL 时，地址可能形如 https://your-domain.example/v1；若客户端会自动追加 /v1，则填写站点根地址。避免生成 /v1/v1 或把 /chat/completions 重复追加到地址。示例域名仅作格式说明，请替换为实际地址。

使用密钥所属分组允许的模型标识，保留名称中的大小写、版本号与后缀。首页展示的模型品牌不等于当前账号已获得该品牌全部模型的权限。

可用模型与支持的请求格式，以控制台模型清单、本站接入说明及实际响应为准。文本、图片等任务可能使用不同端点，不要假定所有模型都支持同一种接口。

如果本站为该密钥提供 OpenAI 兼容的模型列表端点，可先发出下面的查询请求。API_BASE_URL 应填写包含正确前缀的实际基础地址，并先在本地环境中设置 API_KEY。此示例用于验证地址与鉴权，不会证明所有模型或生成能力都可用。

模型查询成功后，再按所选模型支持的接口发送一个小请求，检查 HTTP 状态码和响应内容；流式调用还应确认客户端能正确读取持续返回的数据。

API_BASE_URL='https://your-domain.example/v1'
curl "$API_BASE_URL/models" \
  -H "Authorization: Bearer $API_KEY"

在用量记录中核对调用模型、输入输出用量、缓存相关字段与最终费用。实际扣费以本站分组配置、价格和用量记录为准，不应仅依据第三方供应商价格估算。

缓存命中、缓存写入以及相关费用的展示取决于上游返回和本站计费配置。对接到其他平台时，还取决于对方是否解析这些用量字段以及采用什么计费规则。

先记录请求时间、模型、HTTP 状态码和错误信息，再按下面的顺序检查。向管理员反馈时可提供请求标识，但请隐藏完整 API Key 和敏感请求内容。