*更新日期: 2026-11-07*

# 超时与限制

对接时按下面的上限设客户端超时，不要用 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 查询。
