面接を要約する
https://api.curriculo.me/public/summary/ステートレス。 は面接を highlights、red_flags、skills_mentioned、decision_recommendation、decision_reasoning 、およびオプションの話し手時間 analyticsに変換します。書き起こしのテキスト、書き起こしのドキュメント、または書き起こしと要約するために送信する録音を1つのリクエストで送信します。
価格: $0.01 を書き起こしのリクエストごとに請求します。録音の場合、オーディオの時間당 $0.002 プラス $0.01 です。 価格と請求を参照してください.
書き起こしモード
application/json。1つの面接の JSON オブジェクト、または最大10個の JSON 配列を送信します。各面接には独自の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時間の録音に対応可能です。
[!NOTE] メディアのトランスクリプションが有効になっていない場合、レコーディングは
503を返します。代わりにトランスクリプトを送信してください。
レスポンス
上記のサマリー欄と、 interview_id のエコーが返されます。JSONの配列のインタビューは、入力順で results の配列を返します。 バッチ処理を参照してください。.
タイミング
トランスクリプトの場合、15〜20秒です。レコーディングの場合、長さによって時間がかかります。
エラー
| ステータス | 典型的な原因 |
|---|---|
400 | 空のトランスクリプト、読み取り不可のファイル、または重複したJSONキー。 |
413 | 200,000文字を超えるトランスクリプト、10を超えるインタビューまたはファイル、またはサイズ制限を超えるファイル。 |
422 | transcript_text が欠けている、またはフィールド名が間違っています。 |
503 | メディアのトランスクリプションが有効になっていない場合、代わりにトランスクリプトを送信してください。 |
504 | 処理時間が300秒を超えました。使用 /summary/async. |
Updated