鉴权与地址
三种地址不要混用
| 用途 | 地址 | 如何拼接 |
|---|---|---|
| 原始 HTTP 请求 | https://api.manxiaobai.online |
自己添加完整 /v1/... 或 /v1beta/... 路径 |
| 自动附加资源路径的 OpenAI 兼容客户端 | https://api.manxiaobai.online/v1 |
客户端再添加 /images/generations 等路径 |
| Gemini 原生 HTTP | https://api.manxiaobai.online/v1beta/models/{model}:generateContent |
{model} 替换成本站公开模型 ID |
最常见错误是出现 /v1/v1/images/...，或把管理后台地址 /dashboard 当成 API Base URL。某些第三方工具会自己附加 /v1，应以它最终发出的 URL 为准。
API Key 鉴权
http
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
把 YOUR_API_KEY 换成令牌管理生成的实际 Key；Bearer 后有一个空格。Key 属于敏感凭证，不能写入客户端网页、公开仓库、截图或反馈日志。
网页的登录 Cookie 与 API Key 是两种用途不同的凭证。接入程序使用令牌管理创建的 Key，不要复制浏览器 Cookie。
Key、分组与模型
一个 Key 的可用性同时受到用户权限、所选分组、令牌额度/有效期、模型限制及可用渠道影响。首页与模型广场的最低价是公开分组的最低报价，不代表当前 Key 已选择该分组。
请求体中的 model 只能选择模型，不能用 group 字段切换令牌的计费分组。需要换组时在控制台调整或创建相应分组的 Key；执行中的任务继续用原 Key 查询。
bash
curl --fail-with-body https://api.manxiaobai.online/v1/models \
-H "Authorization: Bearer $MXB_API_KEY"
响应常见结构为 {"object":"list","data":[{"id":"gpt-image-2.5",...}]}。模型 ID 区分完整名称；不要擅自删除 -1k/-2k/-4k 后缀。
同源代理与跨域
站内页面有 /api-proxy/ 兼容入口，例如 /api-proxy/images/generations/async，路径中没有第二个 /v1。它不是公开免鉴权代理；第三方服务应使用正常 /v1/ 地址。
第三方网页跨域 fetch 当前没有完整 CORS 支持。正确部署方式为：用户浏览器 → 你自己的后端 → 本站 API。后端注入 Key，并对你自己的用户做鉴权、额度和速率控制。
请求与日志
- JSON 使用 UTF-8，明确
Content-Type: application/json。 - multipart 上传让 HTTP 库生成 boundary，不要手动写不匹配的 Content-Type。
- 保存模型、时间、HTTP 状态、
task_id和返回的request_id。图片任务 ID 与计费 request_id 不等价。 - 不要将完整请求头或 Base64 图片写进公共日志；诊断日志也应脱敏 Key。