持續本地化，無論您的內容位於何處：它能到達這裡並返回。

REST API、零依賴 CLI、當行被拒絕時使作業失敗的 GitHub Action、供您自有代理使用的 MCP 伺服器、十二個簽名 webhook、二十種檔案格式和四十一個連接器。

免費開始使用閱讀 API 概覽

push

項整合，全部免費: 41
項整合，全部免費
檔案格式: 20
檔案格式
MCP 工具: 17
MCP 工具
已簽署的 Webhook: 12
已簽署的 Webhook

各種觸達方式您目前已運行的環境。

一個標記，因為這是一個承諾：無論您的內容存放在何處，都能傳送到此並回傳。沒有私有 API，儀表板是您所取得的相同 v1 版本的用戶端，且全部 41 項整合皆已包含，無需額外購買。

41 項整合

全部免費

無論字串目前存放於何處。

32 項支援雙向同步。其中 9 項僅支援匯入，卡片上已有標示。

MCP 伺服器

17 個工具

您的代理程式皆能使用。

相同的動詞、相同的閘道控制，適用於您正在執行的任何代理程式。

agent which keys fail length in de?

mcp 3 keys

agent re-draft them inside budget

mcp gates 4 of 4 pass

檔案格式

完整往返支援

JSON、XLIFF、.po、ARB、.strings、YAML、RESX、Markdown、Unity、Unreal 以及另外十種格式。

12 個事件

簽署式 Webhook。

batch.completed
translation.reviewed
qa.completed
source_drift.repaired

自用條款

沒有私有 API。

儀表板是使用與您令牌所呼叫之相同 v1 版本的客戶端。

遷移入門

免費，適用於所有方案

Lokalise, Phrase, Crowdin, Transifex, Weblate and POEditor。

金鑰、語系與記憶庫自動遷移，無需重新輸入。

處理管線

CLI、Action 與紅色勾號。

npx transglot push
transglot/transglot-action@v1
拒絕時退出 4
合併時發布

相同的 v1 儀表板使用。

編輯來源、選擇語言環境、發送。路徑和速率限制是真實的。返回的批次為測試數據，並已註明。

POSTapi.transglot.ai/v1/pushx-ratelimit-remaining：每分鐘 60 次，每個權杖剩餘 60 次

請求主體

checkout.cta

{
  "keys": [
    {
      "key": "checkout.cta",
      "source": "Pay {amount} now"
    }
  ],
  "locales": ["de-DE", "fr-FR", "ja-JP", "ar-EG", "pt-BR"]
}

Authorization: Bearer tgl_… · 一個專案，五種能力

回應

尚未傳送任何內容_
編輯左側原始碼、選擇語言環境並傳送。批次將在此處串流輸出

相同的請求通過另外三個管道，以及回傳的內容

$ npx transglot push
reading transglot.json · 1 key changed
flux: drafting 5 locales
gates: 4 of 4 pass · batch #4181 completed

瀏覽器中的模擬。POST /v1/push，其功能與每分鐘六十次的限制為正式 API；批次 ID、草稿與時間皆為固定資料，此處不會向任何地方傳送資料。

控制台即 API 用戶端

推送、翻譯、閘控與拉取，每一項皆為 REST 端點。

下圖中的每一列背後皆對應一條路由：推送、閘控、術語庫、批次與拉取，皆可透過專案 Token 從您的程式碼存取。控制台中的 API 遊樂場會針對您的專案即時執行唯讀操作，讓您優先檢視真實回應。

app.transglot.ai

acme/app · mainpush

gatesplaceholders · plurals · glossary · length

glossary"boring" locked

batch 4181running

pullde-DE · json

您上傳原始檔
POST/v1/push
閘控面板自動填入
POST/v1/qa/run
您鎖定術語
POST/v1/glossary
批次檢視自動輪詢
GET/v1/batches/:id
您取回翻譯內容
GET/v1/pull

每個面板對應一條路由，每分鐘 60 次，權限依 Token 而定 · 匯出翻譯也是一個端點

從任何儲存庫執行單一指令。

CLI 從設定檔讀取您的檔案和格式並上傳，伺服器僅翻譯變更的內容。使用 --wait 時，它會停留直到運行完成。GitHub Action 運行相同的 CLI，將翻譯後的檔案提交到工作流程運行的分支，並在行被拒絕時使作業失敗。

具備差異感知能力，未變更的字串不會產生費用
與控制台相同的四道閘門
使用 --wait 時，當行被拒絕時退出碼為 4
從 Starter 方案即可使用

免費開始使用 API 概覽

此為執行過程的示意圖，並非實際錄影。

illustrative run

範例執行

從終端機開始，在 Pull Request 中完成。

初始化專案，推送您的原始檔並拉取翻譯。在 CI 中，GitHub Action 運行相同的命令，將檔案提交到分支，並在行被拒絕時使作業失敗。CLI 發布於 npm，無需其他依賴項。

acme / checkoutsixty seconds

$ npx transglot init

wrote transglot.json, 3 locales mapped

$ npx transglot push --wait

diff: 6 strings changed

drafted 18 rows, Glossa Flux

gates: placeholders, plurals, glossary, length

de-DE placeholder {total} missing

repaired once, re-gated, pass

batch complete, 18 rows gated

$ npx transglot pull

written locales/de-DE.json

您可以自動化的事項，以及所需成本。

根據已發布的列舉與路由表計算，而非文件。

20
檔案格式（雙向支援）
JSON（扁平與巢狀）、Android XML、iOS .strings、.stringsdict 與 .xcstrings、Flutter ARB、Laravel PHP 與 JSON、XLIFF 1.2 與 2.0、gettext .po、YAML、CSV、XLSX、Java properties、RESX、Markdown、Unity CSV 與 Unreal PO。其中七種支援複數形式。
push
pull
12
Webhook 事件
batch.completed、batch.failed、key.created、key.updated、key.deleted、translation.updated、translation.reviewed、language.added、language.removed、glossary.updated、qa.completed 與 source_drift.repaired。每次傳遞均使用時間戳記進行 HMAC 簽署。
已簽署
Starter 及以上方案
17
MCP 工具
專案和語言讀取、add_language、翻譯讀取和寫入、translate_missing、批次狀態、列表、重試和取消、run_qa、四個詞彙表工具，以及 pull_file 和 push_file。與 REST API 具有相同的端點和令牌能力。
代理程式
Starter 及以上方案
5
權杖功能
推送、拉取、管理、讀取與寫入，並提供三種功能的部署子集供 CI 使用。最小權限原則為預設值，而非需額外設定的選項。
專案權杖
3
遷移匯入工具
Lokalise, Phrase, Crowdin, Transifex, Weblate and POEditor。金鑰、地區設定與翻譯記憶庫皆會一併遷移，因此無須重新輸入。
單向匯入
4
工作區角色
管理員、開發人員、審閱者與譯者（依專案劃分範圍），另含帳戶擁有者與帳務成員。所有方案（包括免費方案）皆支援。
存取控制

權杖，以及由此衍生的 CLI、Action、API、Webhook 與 MCP，皆需付費方案。免費方案僅提供主控台及其允許的連接器。

將這些複製到您的 CI

值得借鑑的三條管線。

封鎖合併

在拉取請求上運行 Action，將其 commit 輸入設為 none，新增一個步驟以在拉取的檔案缺少金鑰時失敗，並將該作業設為分支保護中的必要檢查。若無此步驟，重新運行或新提交可能會在行仍被拒絕的情況下通過。

合併時發布

當 main 分支移動時，使用具有 manage 能力的令牌為每個區域設置呼叫發布端點。讀取最新 URL 的應用程式無需重新部署即可獲得新版本。

讓代理程式修復尾端

使用 TRANSGLOT_TOKEN 中的專案令牌啟動 MCP 伺服器。您的代理可以讀取批次的失敗金鑰及其原因，通過閘道重試它們，或寫入修復內容，這將保存為人工編輯。

FAQs

其餘內容請參閱文件。以下是決定您是否開始使用的關鍵問題。

是否有可從自有程式碼呼叫的本地化 API？

是的：REST API v1、CLI、GitHub Action、擁有十七個工具的 MCP 伺服器，以及十二個簽名 webhook 事件。所有這些都需要專案令牌，可從 Starter 方案取得。

我可以將翻譯納入 CI 管線嗎？

是的。GitHub Action 推送您的原始字串，等待運行完成，拉取翻譯後的檔案並將其提交到工作流程運行的分支。當行被拒絕時，已完成的翻譯仍會被提交，但作業會失敗。僅超過長度限制或在 Warn 下缺少必要詞彙表用語的行會被寫入而非拒絕，因此不會導致作業失敗。從 Team 方案開始，自動核准或 QA 運行會將其標記以供審查。若要因被拒絕的行而阻止合併，請在拉取請求上運行 Action，將其 commit 輸入設為 none，新增一個步驟以在拉取的檔案缺少金鑰時失敗，並將該作業設為分支保護中的必要檢查。若無此步驟，重新運行或新提交可能會在行仍被拒絕的情況下通過。

是否有你們使用而我們無法使用的私有 API？

沒有。主控台呼叫的 v1 端點與您的權杖所呼叫者相同。當端點變更時，雙方都會受到影響，且變更內容會刊登於 API 變更紀錄中。

CLI 需要什麼？

Node 與專案權杖。它發布於 npm，沒有其他相依性，並從您儲存庫中的單一檔案讀取設定。

Webhook 如何進行身分驗證？

每次傳遞都帶有時間戳記標頭，以及針對時間戳記和主體的 HMAC 簽章。請驗證兩者。我們發布時間戳記，以便您可以強制執行自己的重放視窗；我們不會為您強制執行。

我需要哪種方案才能使用 API？

免費方案無法產生權杖，因此 CLI、Action、API、webhooks 和 MCP 均從 Starter 方案開始，每月 19 美元，包含 300,000 字。

我可以匯出我的資料嗎？

可以，透過 pull 端點、CLI、CDN 套件或檔案儲存同步至 S3、Dropbox 或 Drive。這些功能都不會透過瀏覽器中的按鈕執行，因此請在需要之前將其中一項整合到您的管線中。