メインコンテンツへスキップ
模擬面接は 練習ラウンド です。リアルに感じられる一方で、参加者は好きなだけ何度でも再挑戦でき、改善方法に関するフィードバックを常に受け取れます。 これはセルフサービス型プロダクト（学習アプリ内の「AIで練習する」ボタンなどを想像してください）で最も一般的なセットアップです。
Developer → API Keys から取得したAPIキー（iv_live_...）が必要です。これを x-api-key ヘッダーに設定し、<slug> をご自身のチームスラッグに置き換えてください。

​
ステップ 1 — リアルな面接担当者を作成する

リアルで歯ごたえがありつつ、改善フィードバックをオンにします。 
curl -X POST "https://www.intervyo.ai/api/v1/interviewers?accountSlug=<slug>" \
  -H "x-api-key: iv_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "FAANG Mock Interviewer",
    "persona": "Jordan, a big-tech interviewer running a practice round.",
    "useCase": "training",
    "evaluationDimensions": [
      { "name": "Problem Solving", "description": "Approach and edge cases", "weight": 60 },
      { "name": "Communication",   "description": "Thinks out loud",         "weight": 40 }
    ],
    "interaction": { "tone": "challenging", "difficulty": "hard", "probingDepth": "high" },
    "output": { "includeImprovementFeedback": true }
  }'
👉 id を AGENT_ID として保存してください。

​
ステップ 2 — 練習用テンプレートを作成する

curl -X POST "https://www.intervyo.ai/api/v1/roles?accountSlug=<slug>" \
  -H "x-api-key: iv_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "template_name": "DSA Mock Interview",
    "use_case": "training",
    "description": "A practice coding interview for new grads.",
    "objective": "Help the candidate feel ready for a real interview.",
    "success_outcome": "pass_fail",
    "default_session_mode": "practice_session",
    "default_duration_minutes": 45
  }'
👉 id を TEMPLATE_ID として保存してください。

​
ステップ 3 — 繰り返し可能なラウンドを1つ追加する

ステージは1つ、タイプは practice_session、再受験はオンにします。 
curl -X POST "https://www.intervyo.ai/api/v1/rounds?accountSlug=<slug>" \
  -H "x-api-key: iv_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "role_id": "TEMPLATE_ID",
    "type": "practice",
    "stage_name": "Mock Round",
    "stage_type": "practice_session",
    "stage_order": 0,
    "allow_retake": true,
    "duration_minutes": 45,
    "interviewer_id": "AGENT_ID"
  }'

​
ステップ 4 — 練習するユーザーを追加する

結果をあとで突き合わせられるよう、external_id には自社アプリのユーザーIDを使用してください。 
curl -X POST "https://www.intervyo.ai/api/v1/participants?accountSlug=<slug>" \
  -H "x-api-key: iv_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Priya Patel",
    "email": "[email protected]",
    "external_id": "user_98213",
    "role_id": "TEMPLATE_ID",
    "profile": { "title": "New Grad", "experienceLevel": "entry" }
  }'
👉 id を USER_ID として保存してください。

​
ステップ 5 — 模擬面接を開始する（何度でも）

ユーザーが「練習」をクリックするたびに、新しいセッションをスケジュールします。 
curl -X POST "https://www.intervyo.ai/api/v1/sessions?accountSlug=<slug>" \
  -H "x-api-key: iv_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "candidate_id": "USER_ID",
    "role_id": "TEMPLATE_ID",
    "stage": "practice"
  }'
再受験がオンになっているため、ユーザーが望むだけ何度でもこれを実行できます。

​
ステップ 6 — 成長を可視化する

ユーザーのセッション一覧を取得し、自社アプリ内で「スコアの推移」グラフを描画しましょう。

ユーザーの受験履歴を取得する

GET /api/v1/participants/{id}/sessions で、すべての練習の受験記録が返されます。

​
自社アプリ内に組み込みたいですか？

模擬面接は、自社プロダクトの中に直接組み込むことで真価を発揮します。トークン認証ウィジェットでライブ面接を埋め込めば、こちらへのリダイレクトは不要です。

ウィジェットを埋め込む

ホワイトラベル化されたAI面接担当者を自社アプリに組み込みます。
コーディングの模擬面接では、コード実行 エンドポイントが候補者のコードをテストケースに対して実行し、ケースごとに合否（pass/fail）を返します。
最終更新日 2026年6月30日