持续本地化，无论内容位于何处：内容抵达此处并返回。

REST API、零依赖 CLI、在行被拒绝时使作业失败的 GitHub Action、供您自有代理使用的 MCP 服务器、十二个签名 webhook、二十种文件格式和四十一个连接器。

免费开始阅读 API 概览

push

集成，均不收费: 41
集成，均不收费
文件格式: 20
文件格式
MCP 工具: 17
MCP 工具
签名 Webhook: 12
签名 Webhook

内容触达的每一种方式您已在运行的内容。

之所以称为“Mark”，是因为它代表一个承诺：无论您的内容存储于何处，都能在此接入并返回。这里没有私有 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 API 的客户端。

迁移

免费，所有套餐

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

示例运行

从终端开始，在拉取请求中完成。

初始化项目，推送源文件并拉取翻译。在 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、Webhook 和 MCP 均从 Starter 套餐开始，该套餐每月 19 美元，包含 300,000 字。

我可以导出我的数据吗？

可以，通过拉取端点、CLI、CDN 捆绑包或同步到 S3、Dropbox 或 Drive 的文件存储实现。这些操作均不在浏览器中通过按钮运行，因此请在需要之前将其中一种方式接入您的流水线。