摘要翻譯 SSE

連線資訊

注意：本端點只接受 POST（JSON body），瀏覽器原生的 EventSource API 無法使用。請改用 fetch API 搭配 ReadableStream，或任何能讀取串流回應的 HTTP 客戶端。

端點總覽

與重新翻譯摘要的差異：

• 重新翻譯摘要：輸入是服務端為該錄音保存的摘要，不計費。
• 本端點：輸入是請求帶入的 content，適用於服務端沒有的內容，例如合併後的摘要、使用者編輯過的摘要。

兩者翻譯的方式相同，結果都不會儲存，只以串流回傳給客戶端。

v1.17.0 新增。

請求參數（JSON body）

錯誤回應模式

本端點供後端系統整合使用。串流開始前的錯誤一律回真實 HTTP 狀態碼（JSON body），與 Ad-hoc 摘要 相同：

422 的 JSON body 會在 data.details.errors 列出各欄位的錯誤訊息。

計費

• 依 content 的字元數計費：每 200 字元 0.1 點（未滿 200 字元以 200 字元計），與全文重新翻譯的費率相同。
• 例：450 字元＝0.3 點；30,000 字元＝15 點。
• 翻譯成功才計費；以 error 結束的請求不計費。
• 被截斷的譯文（見下方「處理時間與截斷」）照常計費；判定為「沒有翻完」的譯文不計費。有沒有實際扣點，一律以 done 的 billed 為準。

重複請求與計費保證

系統以整份請求內容（content、target_language、source_language）判斷兩次請求是否為同一次工作的重試：

idempotency_key 只在同一把 API Key 內有效。要翻譯新的內容，或換成另一種語言，請帶新的 idempotency_key。

請求範例

curl -N -X POST "https://vas-poc.vurbo.ai/api/v1/sse/summary/translate" \
  -H "X-API-Key: vas_aB3dE5fG7hI9jK1lM3nO5pQ7rS9tU1vW" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "## 會議摘要\n\n1. 產品上線時程確認為下月初",
    "target_language": "ja-JP",
    "source_language": "zh-TW",
    "idempotency_key": "summary-7f3a-ja"
  }'

事件序列

1. connected              → 連線確認
2. summary_translation    → 譯文（重複 N 次，累積式）
3. done                   → 翻譯完成
   或
   error                  → 翻譯失敗（流程中止，不會送出 done）

connected

{ "message": "Summary translation stream connected (target_language: ja-JP)" }

summary_translation

{ "text": "## 会議の要約\n\n1. 製品のリリース時期は来月初めに確定", "is_final": false }

長內容的串流方式：內容較長時，串流常會一次送出一大段（可能達數千字），兩則之間也可能停頓數秒。每一則仍是累積全文，順序與原文一致。

如果要在畫面上逐字呈現，請在客戶端自行做平滑處理。

done

{
  "tokens_used": 230,
  "source_language": "zh-TW",
  "target_language": "ja-JP",
  "characters_billed": 24,
  "charged": "0.1",
  "idempotency_key": "summary-7f3a-ja",
  "billed": true
}

收到 truncated: true 時，最後一則的 text 不是完整譯文。建議不要當作正式譯文保存，可以提示使用者重試。

處理時間與截斷

• 一次請求的處理時間上限約 230 秒，從送出請求開始算。
• 時間到時，如果已經有譯文，會把目前的內容當成截斷送出：done 帶 truncated: true，照常計費。如果連一個字都還沒有收到，就送 error（Translation timed out），不計費。
• 翻譯途中停頓超過 60 秒沒有新內容，會送 error（Translation timed out），不計費。

特有錯誤碼

串流開始前（真實 HTTP 狀態碼加 JSON）：

串流開始後（HTTP 200 加 SSE error 事件）：

以上錯誤都不計費，也不佔用識別碼。

版本：V1.24.1 最後更新：2026-09-28