服务信息
限制与配额
API 网关的请求体、多模态文件与上下文相关限制。
已公布的限制
下表是 API 网关当前公布的限制。请求体大小按整个 HTTP 请求计算，包含 JSON、Base64 数据以及其他请求字段。
| 限制项 | 上限 | 说明 |
|---|---|---|
| 请求体大小 | 256 MB | 单个 HTTP 请求的总大小；超过上限时返回 413，错误码为 request_too_large |
多模态远程文件（fileUri） | 约 1 GiB（处理上限） | 适用于通过公开 URL 提供给多模态理解模型的远程文件；服务处理时会转为 Base64，实际可处理范围还受模型上下文窗口与文件类型影响 |
多模态 URL 说明
fileUri远程文件的大小上限约为 1 GiB。URL 必须能由服务直接访问，不能依赖登录状态、浏览器 Cookie 或临时权限。- 服务配置的
fileUri处理上限为 1 GiB。文件抓取后会先转换为 Base64；由于 Base64 编码会使体积增加约三分之一（约为原文件的 4/3），原始文件接近或超过 1 GiB 时，转换后的数据可能超过 1 GiB 处理上限并返回错误。为避免失败，请为转换后的增长预留空间，不要上传接近上限的文件。 - 仅按 Base64 膨胀计算，原始文件理论上应低于约 768 MiB（1 GiB × 3/4）；实际还应为 JSON 和其他处理开销预留空间。
fileUri的传输上限与请求体上限是两项独立限制：远程文件不会计入提交 URL 的 HTTP 请求体大小，但下载后仍须满足模型的上下文窗口和输入 token 限制。- 如果改为在请求中内联发送文件，通常需要先转换为 Base64；Base64 编码会使数据体积增加约三分之一（约为原始文件的 4/3），因此内联附件还必须满足 256 MB 的请求体上限。
- 其他字段（例如 OpenAI 兼容消息中的
image_url、video_url）可能由具体模型或接口分别限制，请以对应 API 页面和接口返回的错误为准，不要将fileUri的 1 GiB 上限套用于所有 URL 字段。
如果限制发生变化，我们会在此页面更新。