リクエストとレスポンス

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` でアップロードする(リンクフィールドは繰り返し送信することも、1行ごとに送信することもできます)

リクエストサイズの制限

制限	値	対象
リクエストボディ	12 MB	すべての呼び出し、 `/summary/`を除く。より大きなリクエストは、認証前に `413` でエッジで拒否される。
1つのドキュメント	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`
トランスクリプトドキュメント	50MB	`/summary/` PDFまたはDOCXトランスクリプト
録音、同期	100MB	`/summary/` `media`
録音、同期	12MB	`/transcribe/` `media`
バックグラウンドタスクへのアップロード	1ファイルあたり12MB	`/{op}/async` マルチパート
バックグラウンドタスクごとのリンク数	25	`file_urls`, `resume_urls`
リンクによる録音	1GBと2時間	`/summary/async`, `/transcribe/async` `media_url`

どのような天井を超えても、APIは 413を返します。ワークロードを分割するか、長時間の録音を非同期レーンにリンクで送信してください.

[！NOTE] 同期呼び出しも300秒のリクエストタイムアウトで制限されます。処理に長時間を要する大きな録音は 504を返すため、長時間のインタビューの場合は /summary/async を使用することをお勧めします

レスポンスの形状

リストを受け取るすべての操作は、1つの規則に従います: を1件送信してそのアイテムのオブジェクトを取得します。複数送信して、入力順に1件あたりの結果を取得します

複数のアイテムは、入力ごとに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