总结面试内容

POSThttps://api.curriculo.me/public/summary/

On this page

转录模式
文件模式
响应
时间
错误

无状态。 将面试转换为 highlights、red_flags、skills_mentioned、decision_recommendation、decision_reasoning ，以及可选的说话时间 analytics。可以将转录文本、转录文档或录音发送以进行转录和总结。

价格： 每次请求的转录费用为$0.01。对于录音，按音频分钟收费$0.002，外加$0.01。请参阅定价和计费.

转录模式

application/json发送一个JSON对象用于单个面试，或一个JSON数组用于最多10个面试。每个面试都有自己的ID。

字段	类型	备注
`interview_id`	字符串	您的唯一标识符。直接返回，不进行查找。
`transcript_text` (必需)	字符串	原始转录文本，最高可达200,000个字符。
`transcript_entries`	对象[]	可选的结构化转折点（`participant`,`text`,`startTime`,`endTime`）。启用语音时间分析。
`language`	字符串	使用 ISO 639-1代码来渲染摘要文本。默认为英文。

curl -X POST https://api.curriculo.me/public/summary/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -H 'Content-Type: application/json' \
  -d '{"interview_id": "int_0042", "transcript_text": "Interviewer: Tell me about a system you shipped. Candidate: …", "language": "en"}'

文件模式

multipart/form-data 在同一路径上。上传录音或转录文档。

字段	类型	备注
`media`	文件[]	可重复上传最多10个文件。每个文件的内容决定了其读取方式：PDF、DOCX和DOC被视为转录文本（最多50MB）；其他文件被视为音频或视频（例如mp4、mov、mkv、mp3、m4a、wav）并先进行转录（最多100MB）。
`interview_id`	字符串	您的标识符，每个文件在请求中共享。默认为上传的文件名。
`language`	字符串	ISO 639-1代码用于摘要文本。

curl -X POST https://api.curriculo.me/public/summary/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -F '[email protected]' \
  -F 'interview_id=int_0042' \
  -F 'language=en'

录音返回时会附带其转录文本和分析结果，因此无需单独的转录供应商。由于上传的文件由其内容决定，即使转录文件保存有错误的扩展名，也会正确处理。

异步调用必须在300秒内完成。对于长时间的采访，请发送一个链接到 POST /summary/async ，而不是录音：录音最长可达1GB和2小时。

在媒体转录未启用时，录音返回 503。请发送转录文本instead。

响应

上述摘要字段，包含您的 interview_id 回显。一个JSON数组的采访返回一个 results 数组，按输入顺序排列。请参阅批处理.

时间

转录需要15到20秒，录音需要更长时间，取决于长度。

错误

状态	典型原因
`400`	空白转录、不可读文件或重复的JSON键。
`413`	超过200,000个字符的转录文本，超过10个访谈或文件，或者文件大小超过限制。
`422`	`transcript_text` 缺失，或者字段名称不正确。
`503`	媒体转录未启用。请发送转录文本代替。
`504`	处理时间超过300秒。请使用 `/summary/async`.

Updated 12 October 2026