通用约定

鉴权

所有请求都要在请求头带上 API Key：

Authorization: Bearer sk-你的密钥

• 缺少或无效 → 401
• 密钥绑定的订阅已失效 / 已过期 → 403（去控制台续费即可恢复）
• 密钥只能调它所属产品的接口，跨产品使用同样按 401 处理

请求与响应

• 请求体一律 application/json；语音识别还支持 multipart/form-data 上传文件
• 响应体是 JSON；流式响应的 Content-Type 为 text/event-stream
• 时间字段是 Unix 秒级时间戳

错误结构

出错时返回 OpenAI 兼容的错误体，并带上对应的 HTTP 状态码：

{
  "error": {
    "message": "模型「xxx」不存在或未启用，可用清单见 GET /api/relay/v1/models",
    "type": "model_not_found",
    "code": null
  }
}

限流

每把 API Key 有一个「每分钟请求上限」（默认不限，由平台按会员设置）。 超出时返回 429，稍后重试即可。

流式输出

在请求体里加 "stream": true 即按 SSE 返回（data: {...} 行，以 data: [DONE] 结束）。 计费所需的用量由网关在流末尾自动补齐，客户端不用处理。

计费口径

按实际用量计费：Token（对话 / 向量 / 重排）、字符数（语音合成）、秒数（语音识别）、张数（文生图）。 优先扣产品额度（资源包），额度用尽后扣账户余额。每一把密钥的用量在控制台「API Key 管理」页逐把可查。