更新日期
超时与限制
对接时按下面的上限设客户端超时,不要用 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 帧的 id | chatcmpl_ |
| 生图任务 | 异步创建响应 / 任务查询;同步也会落库(门户任务列表) | img_ |
| 视频 | 创建与查询响应的 id | video_ |
同步生图成功体没有对外 id(仍是 { created, data, usage })。异步生图和视频创建返回的 id 就是 GET /v1/tasks/{id} 用的任务 id。同步生图的 img_… 可在门户/管理端任务列表看到,也可用该 id 查询。