AI 为 ATS 构建器提供的 API
本页面面向正在开发招聘软件的产品和工程团队。Curriculo API 将简历、职位要求及面试结果转化为结构化、可供决策使用的数据。您发送一份文档或录音;我们将返回清晰的字段、匹配分数、翻译结果、转录文本或招聘摘要。
API并非需要用户登录的另一个仪表板。您的产品负责保存候选人记录、工作流以及招聘人员UI。CurriculoAPI在幕后处理语言与媒体相关工作,通过 开发者控制台中的唯一密钥实现.
我的 ATS 应该使用哪个 Curriculo 或 API?
使用 解析 ,将传入的简历转换为结构化候选人记录,评估并打分以匹配职位,进行多语言管道的翻译和语言检测,以及用于面试录音的总结或转录。您的 ATS 负责候选人、职位和招聘人员界面;Curriculo 和 API 则通过一个密钥处理其背后的文档、语言和媒体工作。
API的作用
| 能力 | 你发送的内容 | 你得到的回报 |
|---|---|---|
| 解析 CV | 一次请求中包含一个或多个简历(PDF 或 DOCX)。 | 完整的简历以干净、结构化的数据形式呈现:姓名、联系方式、工作经历、教育背景、技能。数值保留在 CV 自身的语言和书写系统中。 |
| 评估候选人 | 一份或多份简历(PDF 或 DOCX)以及职位,以文本、文件或已注册的形式 job_id. | 针对每个 CV,提供包含书面推理的适用性评分、匹配技能、差距及要点总结。 |
| 翻译 | 最多200条字符串,或PDF和DOCX文档。 | 请提供需要翻译的文本。一个失败的项目不会导致整个批次崩溃。 |
| 检测语言 | 一个文本,或最多200个。 | 每种语言的用途,以便在采取行动之前路由 CV 或消息。 |
| 面试总结 | 转录文本、转录文档(PDF 或 DOCX)或录音(视频或音频)。 | 亮点、红旗警示、提到的技能以及带有理由的建议。录音文件连同其转录文本一并返回。 |
| 转录 | 录音。 | 仅转录。 |
| 助理简历 | 一次 CV,然后是纯文本指令。 | 一份可编辑的工作简历,无需重新上传即可提问、编辑或翻译成其他语言。 |
| 筛选面试 | 候选人电子邮件、问题以及您的回调 URL。 | Curriculo 向每位候选人发送邮件,主持录制好的采访,转录每个回答,并将签名后的内容 POST 到您的服务器。 |
大量积压任务及长时间录制作为 后台任务运行:发送链接或上传内容,同时获取 task_id ,并通过轮询或签名回调收集结果。
API不是第二个ATS。
POST /jobs/仅将职位存储为描述,用于评估简历。没有列表,没有分页,没有组织,也没有管道。
示例 ATS 集成
| 步骤 | 你的系统 | Curriculo |
|---|---|---|
| 一工作背景 | 存储作业,并一次性注册到 POST /jobs/ (free)或内联发送 job_details 。 | 用它来评估候选人。 |
| 2.进气 | 将简历发送至 /parse/ 和 /evaluate/,或链接至 /parse/async 和 /evaluate/async 以处理积压工作。 | 按顺序返回结构化的简历和评估结果。 |
| 3.筛查 | 调用 POST /screening-interview ,传入候选邮箱、问题及 a callback_url. | 发送邀请,主持录制,转录答案。 |
| 4.结果 | 验证 X-Curriculo-Signature,然后存储转录、评估和录制链接。 | 将签署结果作为候选人完成时提交。 |
| 5.采访 | 将录音或文本发送至 /summary/. | 返回亮点、风险点和推荐意见。 |
默认多语言
- 发送任何语言的简历。 解析和评估按文档原文进行读取,无需在客户端进行预处理。
- 没有任何内容会被静默地重写。 解析后的值以 CV 自身的语言和书写系统返回。
- 选择输出语言。 评估、面试摘要和简历助手均接受
language设置。 - 路由前先检测。 在任何人类阅读文档之前,对工作流程进行分支。
查看 语言.
开始入门
- 创建您的账户 在 console.curriculo.me。注册完全自助,$5.00 免费信用额度可用于您的首次调用。
- 生成一个 API 密钥 在 API 钥匙 页它对每项操作都立即生效。密钥只会显示一次,因此请将其保存在安全的地方。
- 尝试每种功能 从 API参考 带有真正的 CV 或转录本。
- 将钥匙交给你的工程团队。 每个功能都是一个独立的请求,因此集成规模小且自成一体。
完整指南见 快速入门.
音量、速度和限制
| 什么 | 价值 | 为什么这很重要 |
|---|---|---|
| 文档大小 | 最多10个MB | 涵盖几乎所有真实的 CV,包括扫描型和设计密集型。 |
| CV 处理时间 | 大约10到90秒 | 真正的 AI 分析,而非关键词匹配。将其视为后台任务,而非页面加载。 |
| 吞吐量 | 每分钟大约2到4份简历 | 估计重型工作在同一时间内对容量共享的服务执行三个操作,因此吞吐量随负载变化而变化。 |
| 一次性翻译 | 200个字符串,50,000个字符 | 一次请求即可获取完整的职业生涯页面或 CV。 |
| 访谈记录 | 二十万字符 | 舒适地容纳长篇小组访谈,逐字记录。 |
| 录音 | 同步模式下最多100个MB /summary/ 上传;最多1个GB或2小时通过链接 | 长时间访谈通过 异步通道. |
| 请求速率 | 每分钟每个密钥600次请求 | 超过它返回 429. |
运营层面的预期
- 每个请求都是独立的。 一份文档的失败不会影响其他任何文档,重新发送失败的文档始终是安全的。
- 错误是明确的。 拒绝请求会告诉你原因。见 错误.
- 失败的请求不收费。 同样,后台任务失败或筛选邀请失败也不在此列。
- 使用量按密钥显示。 为不同的环境或团队分发独立的密钥。
- 了解存储的内容。 同步解析、评估、翻译、语言检测、摘要和转录调用在 AI 调用失败时,仅记录简短摘录。已注册的任务、简历助手、后台任务和筛选面试均保留数据。查看 数据处理.
账单
预付费及按次计费,无订阅:$0.01 用于大多数操作(按 CV 或文档列出列表),$0.001 用于语言检测,录音每分钟约 $0.002,发送筛选邀请每人 $0.02。 定价和账单的完整表格.
Curriculo 在您的 AI 助手内部
与API无关,Curriculo ATS团队可以从Claude、ChatGPT、Cursor及其他客户处开展招聘流程。这是另一款产品,拥有独立的登录系统,API 密钥无法访问其工具。查看 MCP 文档.
FAQ
我的 ATS 用户需要 Curriculo 登录吗?
不。您的产品通过开发者控制台中的一个密钥调用 Curriculo 和 API。您的用户从未登录过 Curriculo。
候选人数据是否被存储?
并非通过同步操作,除了当 AI 调用失败时记录的简短摘录。后台任务、已注册的工作、保存的简历和筛选面试都会保留数据;参见数据处理。
我可以发送任何语言的简历吗?
是的。解析后的值保留在 CV 自身的语言和脚本中,而翻译功能支持 202 种语言。
更新于