文件
限额与错误
大小、存储配额、过期范围与错误处理。
限额
| 项目 | 限额 |
|---|---|
| 单文件 | 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。参见上传参数。
未知字段
兼容接口按各自官方的方式拒绝未知参数，不会静默忽略：
| 接口 | 可用参数 | 其他参数 |
|---|---|---|
| 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 中可用。
按内容识别 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 状态。