요청 및 답변

On this page

경로
내용 유형
요청 크기의 제한
반응 형태
사용 및 지출
입구 위생
버전

요청은 JSON 또는 multipart/form-data입니다. 응답은 JSON입니다. 모든 응답에는 X-Curriculo-Request-Id 헤더가 있습니다. 지원에 연락할 때 인용해 정확한 전화를 찾을 수 있도록

경로

동기화 작업은 후속 슬레이스로 끝납니다: /parse/, /evaluate/, /jobs/, /translate/, /detect-language/, /summary/, /transcribe/, /prompt/.
배경 작업 경로는 /{op}/async 및 /{op}/tasks/{task_id}.
스크리닝 경로는 하나 없이 문서화되어 있습니다: /screening-interview 및 /screening-interview/{screening_id}.

내용 유형

운용	받아들여지는 것
`/parse/`, `/evaluate/`, `/prompt/`, `/transcribe/`	`multipart/form-data`
`/detect-language/`, `/jobs/`, `/screening-interview`	`application/json`
`/translate/`	`application/json` 텍스트 또는 `multipart/form-data` 에 PDF 또는 DOCX 문서를 보내기 위해
`/summary/`	`application/json` 기록 또는 기록 문서를 전송하기 위해 `multipart/form-data`
`/{op}/async`	`application/json` 링크 목록 또는 업로드된 `multipart/form-data` (링크 필드는 반복되거나 선당 하나씩 전송될 수 있습니다)

요청 크기의 제한

제한	가치	적용됩니다.
요청 기관	12 MB	`/summary/`를 제외한 모든 전화 더 큰 요청은 인증 전에 `413` 와 가장자리에 거절됩니다.
한 문서	10 MB	`files`, `file`, `resume_pdfs`, `resume_pdf`, `job_file`, 그리고 `/translate/`
요청에 따른 문서	10	`/parse/`, `/evaluate/`, `/translate/` (파일), `/summary/` ( 인터뷰 또는 `media` 파일)
요청에 따른 문서는	200	`/translate/`, `/detect-language/`
캐릭터	50,000	`/translate/` (전체 `texts`및 문서당), `/detect-language/` (텍스트당)
번역본 텍스트	200,000개의 문자	`/summary/` `transcript_text`
기록 문서	50 MB	`/summary/` PDF 또는 DOCX 표본
녹음, 동기화	100 MB	`/summary/` `media`
녹음, 동기화	12 MB	`/transcribe/` `media`
배경 작업에 업로드	12 MB 각 파일	`/{op}/async` 다부문
배경 작업에 대한 링크	25	`file_urls`, `resume_urls`
링크로 녹음	1 GB과 2시간	`/summary/async`, `/transcribe/async` `media_url`

어떤 천장에서도 API는 413를 반환합니다. 작업량을 분할하거나 아싱크 라인에 링크를 통해 긴 녹음을 보내십시오.

동기화 호출은 또한 300초의 요청 타임아웃으로 제한됩니다. 더 많은 시간이 걸리는 큰 녹음으로 504가 돌아옵니다. 그래서 긴 인터뷰를 위해 /summary/async 를 선호합니다.

반응 형태

리스트를 취하는 모든 작업은 하나의 규칙을 따르죠. 는 하나의 항목을 보내, 그 항목의 객체를 얻습니다. 여러 개의 항목을 보내, 입력 순서대로 각각의 결과를 얻습니다.

여러 항목은 입력당 1개의 항목을 반환합니다.

{
  "results": [
    { "index": 0, "status": "ok",    "data": { … } },
    { "index": 1, "status": "error", "error": { "status": 400, "detail": "…" } },
    { "index": 2, "status": "ok",    "data": { … } }
  ]
}

HTTP 상태는 배트가 받아들여졌을 때 200 로 남아있기 때문에 각 항목에 따라 status 을 읽어보십시오. 1개의 읽히지 않는 CV는 다른 9개는 결코 비용이 들지 않습니다. 배팅 참조.

사용 및 지출

응답은 비용 데이터를 포함하지 않습니다. 호출, 오류, 지연 및 추정 부하는 콘솔 → 사용에 있습니다, 키에 의해 필터링됩니다. 가격 및 청구서를 참조.

입구 위생

JSON 체내의 복제 키 (/translate/,/summary/,/detect-language/) 는 400 가 키를 지정하는 것으로 거부된다.
비밀번호로 보호된 PDF는 400로 거부됩니다 . 비밀번호를 제거하고 다시 보내세요.
필드 이름은 사건에 민감합니다.

버전

API 버전 헤더는 없습니다. 표면은 경로에 따라 버전되어 있으며, 추가 변경 (새로운 선택적 필드, 새로운 동작) 는 기존 호출을 끊지 않고 배포됩니다. 알려지지 않은 응답 필드를 무시하는 클라이언트를 작성하십시오.

Updated 12 October 2026