版本更新紀錄

V1.24.1

2026-10-07

修正：觀眾端 API 可從任何網域呼叫

• 觀眾頁放在您自己的網域時，查詢廣播資訊（GET /api/v1/viewer/broadcasts/{token}）與密碼驗證（POST /api/v1/viewer/broadcasts/{token}/verify）原本會被瀏覽器擋下；本版起兩個端點都可從任何網域的網頁直接呼叫。
• 請求不要帶憑證（例如 credentials: 'include'），否則瀏覽器會擋下回應；收到 429 時可讀取 Retry-After 標頭。
• 觀眾字幕串流本來就可從任何網域連線，不受影響；viewer_access_token 請放在網址參數。
• 說明見 觀眾端 API — 從瀏覽器呼叫。

文件：字庫排查範例更正

• 「常見問題排查」的「術語未生效」原本以登記 zh-CN、辨識 zh-TW 為例，但兩者同語族，術語照樣生效；範例改為不同語族的語言。
• 補充：語言代碼無法辨識（例如 zh）也會讓術語不生效，可從 config_updated 的 inactive_languages、unknown_languages 看出這些語言。
• 說明見 字庫使用指南 — 常見問題排查。

V1.24.0

2026-10-07

行為變更：廣播一律即時翻譯

• 廣播（broadcast）一律以即時翻譯進行，start 的 realtime_translation 帶 false 或不帶，都視為 true。計費不變，照舊以即時翻譯計費。
• 主講端與觀眾端都會先收到同一句翻譯的中間結果（is_final: false），最後才收到定稿（is_final: true），請以 sid 加 language 覆蓋顯示；只想顯示定稿結果時，略過 is_final: false 即可。start 的 realtime_translation 帶 false 或不帶的主講端，本版起也會收到中間結果。
• 中途進場的觀眾只會補送最近幾句的原文與已定稿的翻譯，不補送中間結果。
• 說明見 廣播觀眾 SSE — 翻譯結果、語音翻譯操作 — 廣播模式說明、計費說明 — 廣播計費。

行為變更：start 開場檢查名稱與摘要語言的長度

• start 的 name 去掉前後空白後超過 60 字元，或 summary_language 超過 20 字元，會回 invalid_parameter，錄音不會開始；details.field 標示是哪一個欄位。
• 原本可能在開場回 auth_service_error，或開場成功、錄音結束後卻收不到 task_complete。
• summary_mode 為 custom 時，summary_prompt、summary_prompt_slug 只含空白字元視同沒帶：start 會回 summary_mode_field_mismatch；set_summary 沿用先前的設定，從未設定過才回 summary_mode_field_mismatch。
• 說明見 語音翻譯操作 — start、錯誤碼參考 — 通用錯誤。

行為變更：start 檢查只接受固定值的欄位

• start 的 options.speaking_speed、options.profanity_handling、conversation_mode、tts_mode 帶了可用值以外的值，會回 invalid_parameter，錄音不會開始；details.field 標示是哪一個欄位，details.valid_values 列出可用的值。
• 大小寫須完全一致，例如 tts_mode 帶 "Async" 會被拒絕；沒帶或空字串照舊使用預設值。
• 不論錄音類型都會檢查：非互譯的錄音帶了無效的 conversation_mode，或沒開 TTS 卻帶了無效的 tts_mode，同樣會被拒絕。
• 原本無效值會被當成預設值處理，斷線續接後 resume_ok 的設定卻顯示原本送出的值。
• 錄音中以 tts_mode 切換時，值不是 sync 或 async 會回 invalid_data，模式不變，也不會收到 tts_mode_changed；原本會收到 tts_mode_changed，但模式實際沒有改變。
• 說明見 語音翻譯操作 — start、語音翻譯操作 — tts_mode。

行為變更：start_speaking 成功時回覆 status

• 互譯手動模式送出 start_speaking 成功後，會收到一則 status 訊息；原本成功時不回任何訊息。
• 已在說話中再次呼叫時，上一句的定稿照常送出，之後同樣回這則 status，不會回錯誤。
• 浮動字幕串流也會收到這則 status，不帶 status 欄位；依 status 欄位判斷暫停、恢復、停止的做法不受影響。
• 說明見 語音翻譯操作 — start_speaking、浮動字幕 SSE — status。

行為變更：錄音完成事件可能送達兩次

• 極少數情況下，同一錄音的 recording.completed 會送達兩次，兩次的 delivery_id 不同，只看 delivery_id 擋不住。
• 請再以 data.task_id 加 event 判斷是否已處理過；重複送達不會重複扣點。
• 說明見 Webhook 回呼指南 — 冪等處理。

修正：互譯沒帶 speakers 時無法手動說話或調整語者語言

• 互譯（conversation）的 start 沒帶 speakers 時，用戶 1、2 依序對應 transcription_languages 的兩個語言，start_speaking、set_speaker_language 都可正常使用；原本會回 conversation_invalid_speaker。
• speakers 改標為選填，有帶時仍須恰好 2 位；錯誤碼參考中的 conversation_missing_speakers 標示為不再回傳。
• 沒帶 speakers 的互譯，斷線續接後 resume_ok 的設定也會帶 speaker_language_map。
• 說明見 即時語音翻譯指南 — 互譯模式、語音翻譯操作 — start。

文件：互譯的翻譯時機

• 互譯只翻譯整句辨識完成的句子，realtime_translation 在互譯沒有作用，帶或不帶結果相同；互譯的請求範例拿掉這個欄位。
• 說明見 核心概念 — 即時翻譯 vs 非即時翻譯。

文件：術語庫設定的生效時機

• 錄音中更新 terminology、fuzzy_correction、translation_dict，都是送出後的下一句起生效，正在辨識的那一句不保證套用；原本寫「下一個辨識回合邊界」或「立即生效」。
• 說明見 字庫使用指南 — 生效時機。

文件：爪哇語與吳語支援翻譯

• jv-ID（爪哇語）、wuu-CN（吳語）可當翻譯的來源與目標，145 種語言全部支援翻譯；拿掉原本「不支援翻譯」的例外說明。
• 說明見 支援語言清單 — 語言總覽。

文件：tts_stop 回覆文字更正

• tts_stop 成功時 status 的文字更正為「TTS 已停止」。
• 說明見 語音翻譯操作 — tts_stop。

文件：廣播頻道名稱與摘要語言的規則

• 建立與更新廣播時，summary_language 須為支援語言清單中的語言代碼，不符合時回 422 validation_failed。
• 頻道名稱建立後無法修改，更新時帶 name 會被忽略，不會回錯；錄音名稱也不會沿用頻道名稱。
• 更新廣播時沒有提供任何可更新欄位，回 200 且資料不變；原本 REST API 參考寫「至少需要提供一個欄位」。
• 說明見 廣播功能指南 — 步驟 1：建立廣播、廣播功能指南 — 步驟 7：動態更新設定。

V1.23.0

2026-10-05

行為變更：浮動字幕觀眾換取 Token 的頻率限制

• 觀眾換取浮動字幕 Token 改為同一場錄音每分鐘最多 30 次，所有觀眾合計，分享連結無效的請求也計入。
• 不再依請求來源分別計算；同一來源多次送出無效的分享連結，也不會再被暫時限制換取其他錄音的 Token。
• 超過限制時照舊回 HTTP 429（too_many_requests），並帶 Retry-After 標頭。
• 說明見 浮動字幕 Token API — 觀眾分享。

行為變更：服務關閉期間送出 start

• 服務關閉期間（例如維護更新）送出 start，會收到 service_shutdown，不會開始新的錄音，之後連線會關閉。
• 進行中的錄音不受影響，可以照常錄完。
• 客戶端收到後請稍後重新連線，再重新 start。
• 說明見 錯誤碼參考 — 工作階段錯誤。

文件：Webhook 說明更正

• 重試次數更正：同一則通知最多送出 5 次（首次發送加上重試 4 次），間隔 10、30、90、270 秒；原本誤寫為重試 5 次、共 6 次。
• 補充回 3xx、4xx 也會重試，且不跟隨轉址；需要重送已標記為失敗的通知，請聯絡我們。
• Webhook Secret 的產生時機更正：建立 API Key 時可勾選同時產生；設定 URL 時若還沒有 secret 會自動產生（透過批次設定產生的不顯示明文）。
• 儲存 URL 時的驗證請求更正：系統只看接收端是否在 8 秒內回 2xx，不檢查簽章；接收端已啟用驗簽時，請先把 secret 設定到接收端。
• 點數餘額通知的重複通知規則更正：同一帳戶同一種通知 24 小時內只送一次，帳戶點數增加後重新計算；並補充這兩種通知會送到帳戶內每一把啟用中、且已設定 webhook_url 的 API Key，每把各一份。
• 新增「通知對應的 API Key」說明：即時錄音不能指定 callback_url，通知送到取得連線 Ticket 時使用的 API Key；廣播錄音收尾後以開播的 API Key 為準；API Key 刪除後不再送出通知。
• 核心概念 的事件表補上 credit.low、credit.exhausted。
• 說明見 Webhook 回呼指南。

V1.22.1

2026-10-02

修正：即時翻譯中含千分位逗號或小數點的數字

• 含千分位逗號或小數點的數字（例如 1,200、12,500、1,200,000,000、3.14159）在即時翻譯與廣播公告的譯文中保持完整，不再只剩後段（例如「1,200」譯成「200」）。
• 這類數字在譯文中照原文寫法。

V1.22.0

2026-10-02

行為變更：句中夾雜其他語言時的翻譯

• 不是翻譯語言的字詞，即使只有一個字，也一律翻成翻譯語言。
• 人名、公司、品牌、產品、地名、全大寫縮寫、型號、程式碼、網址與電子郵件保留原文；翻譯字典有指定的依字典。
• 原文中已經是翻譯語言的部分不改。
• 摘要翻譯同樣適用；摘要翻譯的數字照原文寫法。

行為變更：翻譯字典的其他語言欄也參與比對

• 字典在其他語言欄填的詞也會拿來比對原文，有些詞的譯文會改照字典。例如辨識語言是中文時，日文句子比對日文欄；中文、日文等句子裡夾雜的英文詞比對英文欄。
• 翻成辨識語言時（例如中翻中），字典有填其他語言的場次也會用到字典。
• 說明見 字庫使用指南 — 字典的其他語言欄也會參與比對、即時語音翻譯指南 — 翻譯結果。

V1.21.1

2026-10-01

文件：多聲道 shared 模式的回應欄位

• 補齊多聲道 shared 模式在回應中的說明，API 行為未變：
  • resume_ok 的 settings.channel_mode 可能是 per_channel 或 shared。
  • session_started 與 resume_ok 的 channels[] 在 shared 模式不帶 transcription_languages，全場語言以 settings.transcription_languages 為準。
  • 斷線續接後，各路的 preparing 由 resume_ok 的快照帶回、不另送事件；開始出字時逐路送出 channel_status（ready，reason: "reconnect"）。
• 欄位明細見 連線與認證 — settings 物件。

V1.21.0

2026-10-01

新增：多聲道 shared 模式（輪流發言）

多聲道新增 channel_mode: "shared"：各路麥克風輪流發言、共用一條辨識，語者依聲音送進來的聲道標記。適合同一時間只有一個人說話的場合。詳見 WebSocket API。

• 計費固定以 1 路採計：每分鐘 1.5 點（語音辨識 1.0＋語者分離 0.5），增減聲道不影響費率；channel_status 的 stt_stream_count 固定為 1。
• 客戶端需遵守：同一時刻只送一路、沒人說話時該路持續送靜音、僅 pcm；語言全場共用，各路不帶 transcription_languages，錄音中不能變更語言（回 channel_language_not_allowed）。
• channels[] 的第一路不可移除（回 channel_remove_not_allowed）。
• 其他聲道的 preparing／ready／error 狀態跟著第一路。
• 暫停恢復後補轉錄整條最後 60 秒，所有聲道一起補。
• 已知限制：換人間隔小於約 0.8 秒時，前後兩人的話可能併成一句、只標一個語者。
• 未開通 shared 的環境仍回 invalid_channel_mode。

文件：多聲道音檔長度上限

• 補充說明：一場多聲道錄音保存的音訊有總量上限（8 路約 70 分鐘），碰到後音檔與錄音時長停在上限當下，逐字稿與扣點照常。

V1.20.0

2026-09-30

新增：金鑰自助查詢端點

新增三支唯讀端點，只回這把 API Key 自己的資料，點數用盡時也可查詢。詳見金鑰自助查詢。

• GET /api/v1/me/credit-lots：扣點會用到的點數批次，含剩餘點數與到期時間。
• GET /api/v1/me/usage：扣點紀錄，每場錄音／廣播、每次匯入／摘要／重翻各一筆，可分頁。
• GET /api/v1/me/key：API Key 的名稱、到期日、每月點數上限與本月花費、併發上限、Webhook 網址，以及是否設定來源 IP 限制。

V1.19.0

2026-09-30

新增：任務列表可只查指定的任務

• GET /api/v1/tasks 新增 task_ids[] 參數（UUID，1～100 筆），只回傳清單內屬於目前帳號的任務；不存在或不屬於目前帳號的 ID 會直接略過。
• status 照樣套用，沒帶時仍只回傳已完成的任務；要不論狀態查詢，請加 status=all。
• 回應格式不變。

修正：任務較多時任務列表回傳失敗

• 任務數量較多的帳號，GET /api/v1/tasks 可正常回傳。

更早的版本見 歷史版本紀錄。

版本：V1.24.1 最後更新：2026-10-07