批处理

On this page

每个操作的上限
三个需要设计的属性
请求队列大于一个请求
评估一个请求队列对一个工作

没有单独的批处理端点。 列表就是批处理， ，一个请求返回所有结果。发送一个项目，您直接得到答案；发送多个项目，结果按照您发送的顺序返回，每个项目一个。

一份清单被计为一个请求：十份简历在一个 /parse/ 调用中花费 $0.01。请参阅定价和计费.

每个操作的上限

操作	列表字段	上限	单项别名
`/parse/`	`files`	10 个文档	`file`
`/evaluate/`	`resume_pdfs`，针对一个工作	10 个文档	`resume_pdf`
`/translate/`	`texts`，或者 `files`	200 个字符串和 50,000 个字符，或者 10 个文档	`text`
`/detect-language/`	`texts`	200 个文本	`text`
`/summary/`	JSON 采访数组，或重复 `media`	10 次采访或文件	单个对象
`/prompt/`	无	每次调用一条指令（有状态）	无
`/parse/async`, `/evaluate/async`	`file_urls`, `resume_urls`	25 个链接	无

三个需要设计的属性

顺序得到保留。 results[i] 总是属于输入 i.
每个项目的失败。 一个有问题的文档会在成功的文档旁边返回一个错误条目，而 HTTP 状态保持不变 200.
批量答案在请求预算内。 在 300 秒预算用完之前从未开始的项目会返回一个 504 条目，而不是影响整个请求。重新提交这些项目。

重新发送失败的项目始终是安全的。它不会创建重复或半完成的记录。

请求队列大于一个请求

对于请求队列，优先使用异步通道:POST /parse/async 或 POST /evaluate/async 每个任务最多占用 25 个链接，立即回答，并通过回调或轮询交付结果。

大量工作同时在共享服务容量上运行三个操作；超过此限制，请求将排队而不是失败。持续吞吐量大约为每分钟 2 到 4 个简历，且会根据负载变化。如果您需要更大的容量，请告知我们具体的数量。请参阅限速.

CV 解析每个文档需要 40 到 90 秒。将 CV 处理视为后台作业，而不是页面加载，并将客户端超时设置为五分钟以上。

评估一个请求队列对一个工作

注册描述一次（免费），然后将简历列表发送到 job_id 返回的内容。内联 job_details 执行相同的作业，但注册可以防止长队列在每个请求中重复发送相同的段落。

# 1. Register the job. Returns a job_id.
curl -X POST https://api.curriculo.me/public/jobs/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -H 'Content-Type: application/json' \
  -d '{"job_details": "Senior backend engineer, Python and FastAPI, Seoul", "label": "BE-Seoul"}'
# -> {"job_id": "job_abc123", "label": "BE-Seoul"}

# 2. Evaluate a list of CVs against it.
curl -X POST https://api.curriculo.me/public/evaluate/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -F 'resume_pdfs=@candidate_a.pdf' \
  -F 'resume_pdfs=@candidate_b.docx' \
  -F 'job_id=job_abc123'

请参阅注册一个工作和评估候选人.

Updated 12 October 2026