下载 Markdown

更新日期

超时与限制

对接时按下面的上限设客户端超时,不要用 OpenAI 默认的几十秒去等生图/视频。

网关等待

场景上限超时表现
普通 HTTP(对话非流式、生图同步等待)5 分钟504 gateway_timeout,不扣费
对话 SSE最长 600 秒(OpenAI 兼容流式)流中断;是否扣费看流有没有正常结束
视频任务创建立即返回;后台生成等待至少约 60 分钟(按时长可更长,上限 2 小时)对外 failed,不扣费

客户端建议:对话非流式 130s,流式 10 分钟,生图 130s,视频创建 30s、轮询总时长 16 分钟。

限流与额度

默认 RPM(可被运营改成 Key 自己的,空则继承租户):对话 120、生图 60、创建视频 20。按「Key × 能力 × 自然分钟」计数。只有带能力标签的 POST 会计数;GET /v1/models、GET /v1/balance 和任务查询不计 RPM。

余额 ≤ 0:非 GET 返回 insufficient_quota;轮询任务、列模型、查余额仍可用。

请求体

  • Content-Type: application/json(SSE 响应除外)。
  • 未知字段会被丢掉,不会 400。不要靠多传字段「试探能力」。
  • messages 至少一条;n、duration / seconds 必须 ≥ 1。
  • 校验失败(缺字段、类型不对)是 400 + invalid_request。

对外 id

能力出现位置前缀
对话成功响应 / SSE 帧的 idchatcmpl_
生图任务异步创建响应 / 任务查询;同步也会落库(门户任务列表)img_
视频创建与查询响应的 idvideo_

同步生图成功体没有对外 id(仍是 { created, data, usage })。异步生图和视频创建返回的 id 就是 GET /v1/tasks/{id} 用的任务 id。同步生图的 img_… 可在门户/管理端任务列表看到,也可用该 id 查询。

超时与限制 · MomoAI算力超市