主题
这里每一项都是上限而非保证的下限,取值可能变动。每秒请求数的上限见速率限制;credit、存储与目录配额见计费。要调高上限,请联络 support@runllama.ai。
文件大小与页数
| 产品 | 单文件上限 | 页数 | 格式 |
|---|---|---|---|
| Parse | 512 MB | 无上限;用 page_ranges.target_pages 或 max_pages 限定 | 130+ 种文档、图片、电子表格与音频格式(完整清单) |
| Extract | 100 MB | 每个任务 500 页;target_pages、max_pages | 同 Parse |
| Classify | 512 MB | 无上限;parsing_configuration.target_pages、max_pages | 同 Parse |
| Split | 512 MB | 无上限;min_pages_per_split ≥ 1 | PDF、DOCX、PPTX |
| Index | 同 Parse | 按套餐(套餐) | 同 Parse;文件数、数据源与嵌入模型按套餐限制 |
| Batches | 随所跑产品而定 | 随所跑产品而定 | 每个批次 10,000 个源文件 |
Parse 内部还有两条逐页上限:每页最多抽取最大的 35 张图片,每页超出 64 KB 的文本会被丢弃。两者都不会报错。音频按分钟计费、电子表格按工作表计费而非按页(定价)。
超过大小上限的文件会在提交时被拒绝:413 Payload Too Large、400 "File size (... MB) exceeds the maximum allowed size of ... MB.",Extract 则返回 413 "File size limit exceeded. Try uploading a smaller file (< 100 MB)."。文件被接收但因过重无法处理时,任务会以 DOCUMENT_TOO_LARGE 或 PROCESSING_SIZE_LIMIT_EXCEEDED 失败。
Parse 的超时
Parse 任务的超时为 base_in_seconds + extra_time_per_page_in_seconds × 页数,在 processing_control.timeouts 下设置。基础值上限为 7,200 秒(2 小时),每页附加值上限为 300 秒(5 分钟)。超出时限的任务以 TIMEOUT 失败;若超出的是你自己设置的超时,则为 JOB_EXPIRE。
{ "processing_control": { "timeouts": { "base_in_seconds": 300, "extra_time_per_page_in_seconds": 30 } } }处理大文件
- 只处理你需要的页:用
target_pages("1,3,7-12",从 1 开始)或max_pages;Parse、Extract 与 Classify 都支持。省时间的同时也省 credit。 - 先切分再抽取,把长文档逐节处理(示例)。
- 换更快的档位处理超大或图片密集的文档,若任务逼近时限就调高超时。整个目录的文件请提交为一个批次。
请求侧限制
| 产品 | 字段 | 限制 |
|---|---|---|
| Parse | user_metadata | 8 组键值对;键 24 字符、值 64 字符、合计 512 字节 |
| Extract | Schema | 5,000 个属性、7 层嵌套、字符串合计 120,000 字符、原始 JSON 150,000 字符(schema 限制) |
| Classify | Rules | 至少 1 条;type 1–50 字符(字母数字、空格、连字符、下划线);description 10–2,000 字符 |
| Split | Categories | 每个任务 1–50 个;名称 1–200 字符;描述最长 2,000;自定义指令最长 5,000 |
| Index | 检索 top_k | 最多 500 |
| Batches | 源文件 | 每批 10,000 个且须在同一个目录;parse_v2 或 extract_v2;Pro 与 Enterprise 套餐 |
| 任意任务 | Webhooks | 每个请求最多 4 个已保存的 webhook_configuration_ids;每个任务最多 10 个端点(含内联 webhook_configurations)(投递限制) |
| 任意请求 | Usage-Tags 头 | 最多 4 个标签、每个最长 64 字符,否则 422;Enterprise、Parse v2 与 Extract v2(Usage tags) |
| 文件、目录、project、组织 | 名称 | 3,000 字符 |
| 目录 | 批量删除 | 每次调用 100 个文件 |
| 目录 | 数量与规模 | 按套餐:每个 project 的目录数与每个目录的文件数(目录限制) |
| 列举类端点 | limit / page_size | 每页最多 1,000 条;Classify 任务列表最多 100 条 |