File Import

預算檢查 → 上傳音檔 → 追蹤處理進度 → 取得結果

curl -X POST "https://vas-poc.vurbo.ai/api/v1/imports/check-quota" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"duration_ms": 3600000}'

{
  "data": {
    "allowed": true,
    "remaining_budget": 48.48,
    "is_unlimited": false,
    "duration_minutes": 25,
    "estimated_cost": 0.4236,
    "remaining_minutes": 2864
  }
}

curl -X POST "https://vas-poc.vurbo.ai/api/v1/imports" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@meeting.mp3" \
  -F 'transcription_languages=["zh-TW"]' \
  -F 'translation_languages=["en-US"]' \
  -F "recognition_mode=multi_speaker"

curl -X POST "https://vas-poc.vurbo.ai/api/v1/imports" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@meeting.mp3" \
  -F 'transcription_languages=["zh-TW"]' \
  -F 'translation_languages=["en-US"]' \
  -F "recognition_mode=multi_speaker" \
  -F "summary_template=meeting" \
  -F 'terminology={"zh-TW": [{"term": "語者分離", "boost": 1.5}]}' \
  -F 'translation_dict=[{"source": "語者分離", "translations": {"en-US": "Speaker Diarization"}}]'

{
  "data": {
    "import_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "pending",
    "stage": null,
    "progress": 0,
    "message": null,
    "original_filename": "meeting.mp3",
    "file_size": "15.2 MB",
    "task_id": null,
    "created_at": "2026-01-15T10:00:00.000Z"
  }
}

curl -X GET "https://vas-poc.vurbo.ai/api/v1/imports/{importId}" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "data": {
    "import_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "processing",
    "stage": "transcribing",
    "progress": 45,
    "message": "正在辨識語音...",
    "task_id": null,
    "error_code": null,
    "error_message": null
  }
}

pending → processing → completed
                    └→ failed

async function pollImportStatus(importId, apiKey) {
  const interval = setInterval(async () => {
    const response = await fetch(
      `https://vas-poc.vurbo.ai/api/v1/imports/${importId}`,
      { headers: { 'X-API-Key': apiKey } }
    );
    const result = await response.json();
    const { status, stage, progress, task_id } = result.data;

    console.log(`狀態: ${status}, 階段: ${stage}, 進度: ${progress}%`);

    if (status === 'completed') {
      clearInterval(interval);
      console.log(`處理完成！Task ID: ${task_id}`);
      // 使用 task_id 載入結果...
    } else if (status === 'failed') {
      clearInterval(interval);
      console.error(`處理失敗: ${result.data.error_message}`);
    }
  }, 5000); // 每 5 秒查詢一次
}

const sentences = [];
// ... 處理 SSE 事件收集 init_sentence

if (sentences.length === 0) {
  // 顯示空狀態
  showEmptyState({
    title: '此音檔未辨識出語音內容',
    hint: '可能原因：音量過小、全程靜音、或辨識語言與音檔不符。建議確認音檔品質或調整辨識語言後重新上傳。',
  });
} else {
  renderTranscript(sentences);
}

curl -X GET "https://vas-poc.vurbo.ai/api/v1/tasks" \
  -H "X-API-Key: YOUR_API_KEY"

const response = await fetch(
  `https://vas-poc.vurbo.ai/api/v1/sse/history/transcribe/${taskId}`,
  { headers: { 'X-API-Key': apiKey } }
);
// 處理 SSE 事件：init_metadata → init_sentence × N → init_summary → init_done

const response = await fetch(
  `https://vas-poc.vurbo.ai/api/v1/sse/audio/${taskId}`,
  { headers: { 'X-API-Key': apiKey } }
);
const blob = await response.blob();
const audio = new Audio(URL.createObjectURL(blob));
audio.play();

const response = await fetch(
  `https://vas-poc.vurbo.ai/api/v1/sse/retranslate/${taskId}?targetLang=ja-JP`,
  { headers: { 'X-API-Key': apiKey } }
);
// 處理 SSE 事件：translation × N → done

{
  "zh-TW": [
    { "term": "語者分離", "boost": 1.5 },
    { "term": "CVD製程", "boost": 2.0 }
  ]
}

{
  "zh-TW": [
    { "correct": "語者分離", "incorrect": ["語這分離", "語者分力"] }
  ]
}

[
  {
    "source": "語者分離",
    "translations": {
      "en-US": "Speaker Diarization",
      "ja-JP": "話者分離"
    }
  }
]

curl -X POST "https://vas-poc.vurbo.ai/api/v1/imports" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@meeting.mp3" \
  -F 'transcription_languages=["zh-TW"]' \
  -F "recognition_mode=multi_speaker" \
  -F "callback_url=https://your-server.com/webhooks/vas"

           ┌────────────────────┐
           │   check-quota      │  檢查預算是否足夠
           │  POST /imports/    │
           │  check-quota       │
           └────────┬───────────┘
                    │
              allowed: true?
               ╱          ╲
             是             否 → 提示預算不足
              │
    ┌─────────▼──────────┐
    │    POST /imports    │  上傳音檔
    │  multipart/form-data│  （transcription_languages,
    │                     │   translation_languages,
    │                     │   recognition_mode, ...）
    └─────────┬──────────┘
              │
         HTTP 202
         import_id
              │
    ┌─────────▼──────────┐
    │  GET /imports/{id}  │  輪詢處理狀態
    │   每 3~5 秒         │  （每 3~5 秒查詢一次）
    └─────────┬──────────┘
              │
        status 判斷
       ╱      │      ╲
   pending  processing  completed / failed
              │              │
         stage:          task_id ←── 處理完成
         converting          │
         transcribing   ┌────▼─────────────┐
         translating    │  Tasks API        │  查看任務列表
         summarizing    │  SSE History API  │  載入逐字稿
                        │  SSE Audio API    │  播放音訊
                        │  SSE Retranslate  │  重新翻譯
                        └──────────────────┘