EzTranslate
開發者文件 管理 API 金鑰
文件導覽

開發者文件

將台語與漫畫翻譯加入你的應用程式。共用一組 API 金鑰，使用 EzTranslate 帳戶中的 Plus 點數。

選擇你要串接的翻譯

API 輸入 取得的結果 開始使用
台語翻譯 中文文字 台語漢字、台羅、白話字；可選擇產生語音 台語翻譯指南
漫畫翻譯 JPEG、PNG 或 WebP 圖片 保留原始版面的翻譯圖片 漫畫翻譯指南

第一次串接

  1. 登入 開發者頁面，建立 API 金鑰並儲存在你的伺服器。
  2. 依照對應指南送出翻譯。每次新翻譯都要先產生並保存重試識別碼。
  3. 收到 202 後，保存回應中的工作 id，透過 statusUrl 查詢進度。
  4. 等待 status 成為 completed，再讀取文字或下載結果。

翻譯會在背景處理。關閉連線不會取消已接受的工作；不必一直保持同一個 HTTP 連線。

串接前需要知道

  • 身分驗證： 每個請求使用 Authorization: Bearer ...。金鑰不能放進公開網頁或手機 App。金鑰與安全儲存
  • 計費： API 使用帳戶中的 Plus 點數（訂閱或購買點數），不能使用每日免費的 Basic 點數。查詢進度與下載不另扣點。計費與退回點數
  • 安全重試： 沒收到回覆時，使用相同識別碼與相同內容重送。改用新識別碼會建立新翻譯。錯誤與重試
  • 結果保存： 完成或失敗後，內容可存取 7 天。請在到期前保存需要的結果。

API 基底網址為 https://eztranslate.com.tw/api/v1。目前版本為 v1。

規格與後續更新

OpenAPI 規格 列出端點、欄位與回應格式，可匯入支援 OpenAPI 的開發工具。

更新紀錄 會以獨立文章說明新功能與相容性變更。需要協助時，請提供回應標頭中的 X-Request-ID，不要寄送完整 API 金鑰。

更新於

© 2026 EzTranslate