一次呼叫,翻完上千筆字串
批次翻譯收的是一份清單,而不是單一字串。一次呼叫會展開成多張分塊子票證平行執行,結果依你送出的順序,每一筆輸入回一筆。計費以筆數計,由核可覆寫回答的筆數會退回。批次只走 API,而且要逐一應用程式開通。
單筆字串與批次的差別
單筆呼叫適合表單欄位或客服回覆這種情境:一個輸入、一個結果、一張票證。批次適合的是你手上已經整理好的一份清單。與其用迴圈打 4,000 次呼叫、再追蹤 4,000 張票證,不如把清單一次送出,只追蹤一個批次,底下的分塊會自己跑。
- 單筆:送一個字串、拿一個結果、追一張票證
- 批次:送一份清單、追一個批次、依送出順序每筆回一筆結果
- 批次內的分塊是平行執行,不是一塊接一塊
以筆數計費,核可覆寫的筆數會退回
批次以筆數計費,一筆是「一段原文翻成一個目標語言」,成本和你實際送出的筆數成正比。由核可覆寫回答的筆數會在結算後退回,這是審稿工作直接反映成帳單金額的地方。由快取回答的筆數則照一般單筆費率計費,該費率本身已經把這份節省算進去了。
上限與批次怎麼切
單一批次最多 5,000 筆,一筆是「一段原文配一個目標語言」— 同一段文字要進三個市場,就算三筆。平台會把清單切成數個分塊,每個分塊各自派成一張子票證,所以一份很長的清單會同時在好幾個分塊上推進,而不是排在一件長工作後面。超過上限的清單就分成多個批次送。
怎麼呼叫,以及怎麼開通
批次是 API 端的能力:送出清單、留下批次 id,然後輪詢到所有筆數完成為止。它的使用情境是匯入程式、CMS 同步或每晚排程,而不是在瀏覽器裡點 — 本站的工具表單一次只能送一個字串,送不了清單。批次也是逐一應用程式授權的:由該應用程式所屬組織的管理員在 Console 開通(應用程式 → 該應用程式 → API 專用管線卡片),開通前該應用程式送出的批次呼叫都會被拒絕。
某一塊失敗時
子票證的分塊是全有或全無:一旦失敗,該分塊裡的每一筆都會一起失敗,同一批次的其他分塊不受影響。你只需要重送失敗分塊的那些筆數,不必重跑整份目錄,批次中其他已完成的筆數會保留結果。
常見問題
一個批次可以放幾筆?
最多 5,000 筆,其中「一段原文翻成一個目標語言」算一筆。更長的清單分成幾個批次送即可,各批次彼此獨立。
我今天就能用自己的帳號呼叫批次嗎?
可以 — 只要有管理員先在 Console 開通你的應用程式。批次是逐一應用程式授權的:組織管理員從「應用程式」→ 該應用程式 → API 專用管線卡片開通,未取得授權的應用程式送出的批次呼叫會被拒絕。單筆字串翻譯則沒有這道手續,開箱就能用。
如果有一塊失敗,整個批次都要重來嗎?
失敗的範圍只到那一張子票證的分塊。該分塊內的每一筆會一起失敗,其餘分塊的結果會保留,你只要重送失敗那一塊的筆數。
如果批次裡大部分內容都翻過了,會收多少錢?
批次裡的每一筆都會計費,其中由核可覆寫回答的筆數會在結算後退回。只由快取回答的內容仍以單筆費率計費,該費率本身已經把這份節省算進去了。