バッチ処理
別のバッチエンドポイントはありません。 リストはバッチであり、 1 つのリクエストですべての結果が返されます。1 つのアイテムを送信すると、直接回答が得られます。複数のアイテムを送信すると、送信した順序で結果が返されます。
リストは 1 つのリクエストとして請求されます: 1 つの /parse/ コールで 10 個の履歴書が $0.01 かかります。 価格と請求についてはこちらを参照してください.
操作ごとの上限
| 運用 | リストフィールド | 上限 | 単一アイテムエイリアス |
|---|---|---|---|
/parse/ | files | 10 個のドキュメント | file |
/evaluate/ | resume_pdfs1つの仕事に対して | 10個の文書 | resume_pdf |
/translate/ | texts、または files | 200個の文字列と50,000個の文字、または10個の文書 | text |
/detect-language/ | texts | 200個のテキスト | text |
/summary/ | JSON のインタビュー配列、または繰り返し media | 10個のインタビューまたはファイル | 単一のオブジェクト |
/prompt/ | なし | 1回の呼び出しにつき1つの指令（状態を保持） | なし |
/parse/async, /evaluate/async | file_urls, resume_urls | 25個のリンク | なし |
設計するための3つのプロパティ
- 順序は保存されます。
results[i]は常に入力に属しますi. - 失敗はアイテムごとに発生します。 不正なドキュメントは成功したものの隣にエラー エントリを返し、HTTP 状態は維持されます
200. - バッチ回答はリクエスト予算内で実行されます。 300秒の予算が切れた前に開始されなかったアイテムは、全体のリクエストを失敗させるのではなく、
504エントリを返します。失敗したアイテムのみを再送信してください。
失敗したアイテムを再送信することは常に安全です。重複したレコードや不完全なレコードを作成することはできません。
1つのリクエストよりも大きいバックログ
バックログの場合、 非同期レーン:POST /parse/async または POST /evaluate/async を使用して、最大25のリンクをタスクごとに処理し、結果をコールバックまたはポーリングで返します。
重い作業は、サービス全体で共有される容量で同時に3つの操作を実行します。その以上の場合、リクエストは失敗するのではなく、キューに追加されます。持続的なスループットは、約2〜4 CV/分で、負荷によって変動します。より多くのボリュームが必要な場合は、ボリュームを教えてください。 レート制限を参照してください。.
CV の解析には、ドキュメントごとに40〜90秒かかります。CV 処理をページ読み込みではなくバックグラウンド ジョブとして扱い、クライアントのタイムアウトを5分以上に保ってください。
バックログを1つのジョブに対して評価する
説明を一度登録（無料）してから、返された job_id に対してCVのリストを送信します。インラインの 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