重新翻譯 SSE

curl -N "https://vas-poc.vurbo.ai/api/v1/sse/retranslate/550e8400-e29b-41d4-a716-446655440000?targetLang=en-US" \
  -H "X-API-Key: vas_aB3dE5fG7hI9jK1lM3nO5pQ7rS9tU1vW"

// 使用 fetch API（因 EventSource 不支援 Header）
async function retranslateSSE(taskId, targetLang, apiKey) {
  const response = await fetch(
    `https://vas-poc.vurbo.ai/api/v1/sse/retranslate/${taskId}?targetLang=${targetLang}`,
    {
      headers: {
        'X-API-Key': apiKey
      }
    }
  );
  const reader = response.body.getReader();
  // ... 處理 SSE 事件
}

0. connected      → 連線確認
1. translation    → 逐條發送翻譯結果（成功句，重複 N 次）
   error          → 句子翻譯失敗（per-sid，與 translation 交錯出現）
   error          → 逐字稿儲存失敗、同時有其他寫入，或 expectedRevision 不符（storage_upload_failed／transcript_revision_conflict，流程中止、**不會**送出 done）
2. done           → 翻譯完成（分段續翻時，也可能是這一段完成）

{
  "sid": 1,
  "text": "Hello",
  "is_final": true
}

{
  "error_code": "sse_translation_failed",
  "severity": "error",
  "message": "SSE translation failed",
  "context": "sse",
  "sid": 5,
  "request_id": "req_abc123",
  "timestamp": "2026-04-26T10:30:45.123Z",
  "details": {
    "translation_language": "ja-JP",
    "original_error": "..."
  }
}

{
  "totalUpdated": 10,
  "characters_billed": 12700,
  "charged": "6.4",
  "billed": true
}

{
  "totalUpdated": 640,
  "characters_billed": 25600,
  "charged": "12.8",
  "billed": true,
  "revision": 7,
  "truncated": true,
  "nextSid": 641
}

async function retranslate(taskId, targetLang, apiKey) {
  const response = await fetch(
    `https://vas-poc.vurbo.ai/api/v1/sse/retranslate/${taskId}?targetLang=${targetLang}`,
    {
      headers: {
        'X-API-Key': apiKey
      }
    }
  );

  const reader = response.body.getReader();
  const decoder = new TextDecoder();

  while (true) {
    const { done, value } = await reader.read();
    if (done) break;

    const events = parseSSE(decoder.decode(value));
    for (const event of events) {
      if (event.type === 'translation') {
        console.log(`句子 ${event.data.sid}: ${event.data.text}`);
      } else if (event.type === 'done') {
        console.log(`完成，共更新 ${event.data.totalUpdated} 句`);
      }
    }
  }
}

curl -N "https://vas-poc.vurbo.ai/api/v1/sse/retranslate/summary/550e8400-e29b-41d4-a716-446655440000?targetLang=en-US" \
  -H "X-API-Key: vas_aB3dE5fG7hI9jK1lM3nO5pQ7rS9tU1vW"

// 使用 fetch API（因 EventSource 不支援 Header）
async function retranslateSummarySSE(taskId, targetLang, apiKey) {
  const response = await fetch(
    `https://vas-poc.vurbo.ai/api/v1/sse/retranslate/summary/${taskId}?targetLang=${targetLang}`,
    {
      headers: {
        'X-API-Key': apiKey
      }
    }
  );
  const reader = response.body.getReader();
  // ... 處理 SSE 事件
}

0. connected              → 連線確認
1. summary_translation    → 逐段發送摘要翻譯（重複 N 次）
   error                  → 翻譯失敗（流程中止，**不會**送出 done）
2. done                   → 翻譯完成

{
  "text": "累積翻譯結果...",
  "is_final": false
}

{
  "totalUpdated": 1
}

# 重翻所有已存在語言
curl -N "https://vas-poc.vurbo.ai/api/v1/sse/recordings/{taskId}/entries/5/retranslate?api_key=vas_xxx"

# 只重翻 en-US，並要求 revision 必須是 3
curl -N "https://vas-poc.vurbo.ai/api/v1/sse/recordings/{taskId}/entries/5/retranslate?targetLang=en-US&expectedRevision=3&api_key=vas_xxx"

1. connected   → 連線確認
2. progress    → 開始翻譯某語言（每語言 1 次）
3. translated  → 該語言翻譯完成（每語言 1 次）
   或 error    → 該語言翻譯失敗
4. done        → 全部完成

{ "sid": 5, "lang": "en-US", "status": "translating" }

{
  "sid": 5,
  "lang": "en-US",
  "text": "Hello world",
  "tokens_used": 25
}

{
  "error_code": "sse_translation_failed",
  "sid": 5,
  "details": { "translation_language": "ja-JP", "original_error": "..." }
}

{
  "sid": 5,
  "revision": 6,
  "original_text_edited_at": "2026-05-06T10:30:00.000000Z",
  "languages_translated": ["en-US"],
  "languages_failed": ["ja-JP"]
}