特殊模型接口

持有 API 密钥后，除了对话，还可以调用下面六类接口。每一次成功调用都会记入个人调用日志和后台请求列表，并按该模型服务的价格计算费用。

供应商没有声明对应接口时，这个用途不能被选中。目录里会写明原因，例如「该供应商不提供重排接口」。

判断

对一段内容回答是非、选择或评分类问题。可在全局设置里选为意图识别模型，也可以分发给调用方通过判断接口使用。

POST /v1/decisions

{
  "model": "your-gateway-model",
  "input": "这笔订单被扣了两次款。",
  "questions": [
    {
      "name": "is_complaint",
      "instructions": "这是不是一条投诉？",
      "type": "predicate"
    },
    {
      "name": "department",
      "instructions": "应该交给哪个部门？",
      "type": "choice",
      "choices": [
        { "value": "billing", "description": "付款、发票和退款。" },
        { "value": "other", "description": "以上都不是。" }
      ]
    }
  ]
}

同一用途还有 POST /v1/systemone。请求体用 state 放被判断的内容，questions 是按题名索引的对象。网关会把它收成同一种判断请求，再按所选上游编码。

计费按 token。判断同时计输入和输出，输出价可以为 0。嵌入只计输入。

限制：

• 一次请求最多 256 题。超过所选上游的单批上限时，网关按上限拆开并发发送，再按题名合并答案。每一批单独记一条用量。
• 选择题至少 2 个选项。评分题至少 1 个等级。题名不能重复。
• 图片只能放在 data: 地址里。不接收图片的上游会返回 400。
• 缺题、多题、答案不在选项里，都会拒绝，并指出是哪一题。
• 请求体上限 32 MiB。
• 不同上游给出的判断分数不能直接比较。

重排

POST /v1/rerank

{
  "model": "your-gateway-model",
  "query": "退款进度",
  "documents": ["订单已发货。", "退款将在三个工作日内到账。"]
}

计费按搜索次数。上游返回搜索次数时用该值；没有返回时，按 1 次查询加每 100 个文档 1 次计算。界面上的价格是每千次搜索。

嵌入

POST /v1/embeddings

{
  "model": "your-gateway-model",
  "input": "把这段文字变成向量。"
}

计费按输入 token。

图像

POST /v1/images/generations

{
  "model": "your-gateway-model",
  "prompt": "一张蓝色背景的产品图",
  "n": 1
}

计费按返回的图片张数。价格按每张填写。

语音合成

POST /v1/audio/speech

{
  "model": "your-gateway-model",
  "input": "你好，这是一段语音。",
  "voice": "alloy"
}

计费按请求文本的字符数，以 Unicode 标量计数。价格按每百万字符填写。请求体上限 32 MiB。

语音转写

上传文件：POST /v1/audio/transcriptions，multipart/form-data，字段为 model 和 file。

计费按音频时长。网关在上传时只读取容器头，不把整段音频解码。库内按秒计价，界面按每分钟填写。认不出格式时返回 400，消息为「无法识别音频格式」。文件请求体上限 25 MiB。

实时转写走 WebSocket。费用按本次会话里收到的音频帧累计时长计算。

错误

模型不支持所调用的接口时，返回 400，消息为「该模型不支持此接口」。所选上游全部失败时返回 502。错误都带中文消息和稳定错误码。状态码的判定依据、reason 全表与三种协议的错误体形状，见错误参考。