# 限额与错误 (/docs/cloud/services/file/limits-and-errors)



## 限额 [#限额]

| 项目                                    | 限额                                                   |
| ------------------------------------- | ---------------------------------------------------- |
| 单文件                                   | 100 MiB（104,857,600 字节）；不接受空文件                       |
| 文件存储配额                                | 20 GiB（21,474,836,480 字节），账户内文件共享                    |
| OpenAI 或文件 API 的 `expires_after`      | `anchor: "created_at"`，3,600–2,592,000 秒（1 小时至 30 天） |
| 文件 API 的 `praxis[expires_in_seconds]` | 3,600–7,776,000 秒（1 小时至 90 天）                        |
| Anthropic 表单 `expires_in_seconds`     | 3,600–7,776,000 秒（1 小时至 90 天）                        |

过期参数只能选一种。Anthropic 的 `expires_in_seconds` 只能放在表单中；放在查询参数里返回 400。参见[上传参数](/docs/api/native/file/createFile)。

## 未知字段 [#未知字段]

兼容接口按各自官方的方式拒绝未知参数，不会静默忽略：

| 接口           | 可用参数                                                                       | 其他参数                                                                                     |
| ------------ | -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| Anthropic 上传 | 表单 `file`、`expires_in_seconds`；查询参数仅 `beta`                                | 400 `invalid_request_error`，如 `purpose: Extra inputs are not permitted`                  |
| OpenAI 上传    | 表单 `file`、`purpose`、`expires_after[anchor]`、`expires_after[seconds]`；无查询参数 | 400 `invalid_request_error`，如 `Unrecognized request argument supplied: foo`，`param` 为该字段 |
| OpenAI 列表    | 查询参数 `after`、`order`、`limit`、`purpose`                                     | 同上                                                                                       |

`praxis[expires_in_seconds]` 与 `scope_id` 等扩展只在[文件 API](/docs/api/native/file) 中可用。

按内容识别 PDF、DOCX/XLSX/PPTX、PNG/JPEG/GIF/WebP、支持的音视频格式和 UTF-8 文本。改扩展名不能让任意二进制文件变成受支持类型。

## 错误处理 [#错误处理]

| 错误                              | 处理方式                                                                       |
| ------------------------------- | -------------------------------------------------------------------------- |
| `PURPOSE_UNSUPPORTED`           | 传入 `user_data`、`assistants` 或 `vision`。                                    |
| `FILE_EMPTY`                    | 上传非空文件。                                                                    |
| `FILE_TOO_LARGE`                | 将单文件控制在 100 MiB 以内。                                                        |
| `FILE_TYPE_UNSUPPORTED`         | 使用支持的文件内容类型，仅修改扩展名无效；`purpose=vision` 只接受图片；损坏的 Office 文档或 ZIP 压缩包也会返回此错误。 |
| `VALIDATION_ERROR`              | 检查文件名与过期参数。                                                                |
| `QUOTA_EXHAUSTED`               | 删除不再需要的文件后重试上传。                                                            |
| HTTP 404                        | 检查 ID、账户以及文件是否已过期或删除。                                                      |
| `File is not an eligible image` | 在对话中使用支持的图片，并以 `purpose=user_data` 重新上传。                                   |

过大的请求可能先被边缘拒绝，返回 HTTP 413 与 HTML 正文，而不是文件 API 的 JSON 错误。解析错误正文前先检查 HTTP 状态。

[API 参考 →](/docs/api/native/file) · [Cookbook →](/docs/cookbook)