你正在搭建一套本地化引擎。真正翻得好的引擎，从来不是空白的那套——而是带着你的品牌语气、术语表和规则运行的那套。这样，每一条译文都像出自你的产品之口，也不会把你早已定好的术语翻乱。
而这些知识，往往在引擎搭好之前就已经存在了。它们可能写在品牌指南页面里、风格指南里、术语表里，或是某位译者曾拿到过的几段规则说明中。手动搭建引擎，就意味着把这些内容全部读一遍，再一条条重新录入成品牌语气、术语表和规则记录——这项工作繁琐乏味，容易开头，更容易做到一半就搁置。
异步预配 API 正好补上了这一步：直接用你已经有的内容。 你只需在一次请求里 POST 链接和原始文本，立刻就能拿到引擎 ID；随后，AI 代理会抓取这些来源，提取品牌语气、术语表条目和规则，并在识别到后逐项应用到新引擎中。从拿到 ID 的那一刻起，引擎就已经可用——配置会随着任务运行逐步补全。
本页内容
问题是什么#
本地化引擎的效果，取决于它的配置。选择模型，能帮你生成译文；而真正让译文符合产品一贯表达方式的，是品牌语气、术语表条目和规则——比如你选定的正式程度、绝不翻译的产品名称，以及始终采用的日期格式。这些也正是你原本需要手动创建的基础配置：品牌语气、术语表条目和 规则，都挂在同一个 引擎 下。
问题在于，这些内容其实早就存在于某个地方。一个已经用某种语言发布过产品的团队，通常已经有品牌指南页面、风格指南，以及一份明确告诉客服哪些术语绝不能翻译的术语表。要手动配置引擎，你得先读这些文档，再把里面的内容逐项转写成记录——一个决策一个决策地整理，一个语言区域一个语言区域地配置。这个过程很慢，而最慢的部分偏偏也最没意思：把已经写下来的知识，换一种形式再抄一遍。
预配省去了这一步。你把文档本身交给平台——无论是可抓取的 URL，还是原始文本——接下来由 AI 代理完成读取和转写。它会直接在真实引擎上为你创建品牌语气、术语表和规则记录，并在识别出每一项后立即应用。之后，你还可以像编辑自己创建的内容一样，在控制台中审核和调整。起点不再是空白引擎，而是一套已经完成配置的引擎。
预配负责配置引擎，不负责翻译。
这个 API 的作用是创建并配置引擎。等引擎就绪后，如果你要用它来翻译，多语言同时处理请使用 异步 Localization API，单个语言对则可使用 同步 Localize 端点。预配是前置的设置步骤，它确保这些调用从第一次翻译开始，就带上你的品牌语气和术语表。
工作方式#
整个过程分三步，而真正发生在你的请求里的，只有第一步。其余两步都由平台在后台自行运行——这也正是为什么调用会立刻返回，以及为什么工作尚未完成时，引擎就已经可以使用。
提交你的资料来源
AI 代理抓取并提取内容
链接来源会并行抓取并转换成文本；原始内容则直接读取。随后，AI 代理会分析全部内容，提取三类配置——品牌语气、术语表条目和规则——并在识别到后逐项应用到引擎中。即使某个来源抓取失败，或某一条目无法创建，也不会影响其余部分继续处理。AI 会提取哪些内容 介绍了这三个组成部分，以及它们如何映射到不同语言环境。
引擎已准备就绪
当提取完成后，引擎就已完成全部配置，可以通过 Localization API 进行翻译。平台会将完成状态——以及所有已创建内容的摘要——发送到你的 webhook URL；如果你希望在运行期间展示进度，也可以通过 任务的 WebSocket 实时获取更新。
引擎 ID 可立即使用。
你在 eng_ 中收到的 202 ID，从收到的那一刻起就对应着一个真实可用的引擎。你可以立刻保存、引用，并马上用它发起翻译——配置会随着任务运行逐步应用，所以越早发起的翻译，能用到的提取记录会少于任务完成后发起的翻译。你无需等预配完成，才能开始使用这个引擎。
身份验证
每个请求——无论是 REST 还是 WebSocket——都通过你的 X-API-Key 请求头进行身份验证。密钥以组织为作用域，可访问组织内的所有引擎。详情请参见 Authentication，创建密钥请参见 API Keys。
你会得到什么#
看到这里，谨慎的读者大概已经在问两个决定它是否值得依赖的问题：如果来源质量不好怎么办？以及，这会不会是一个我无法纠正的黑箱？
这两个问题的答案都不会被藏起来。预配返回的不是一个专有黑盒，而是在真实引擎上创建出的普通品牌语气、术语表和规则记录——也就是你手动创建时会得到的那一模一样的对象，而且之后每一项都可以在控制台中编辑。任务完成后，它还会返回一份摘要，列出它创建的每一条记录，以及遇到的每一次失败，让你能核实配置结果，而不是只能默认它没问题。AI 会提取哪些内容 会进一步说明这份摘要，以及某个失败项如何被单独归入 errors 列表，而引擎其余部分仍会继续完成配置。
来源同样是可选的。如果你只提交一个名称而不带 sources，你拿到的会是一个使用默认配置的干净引擎，后续可自行配置——创建预配任务 会同时介绍这一路径，以及 202 的响应结构。预配的作用，是帮你跳过手动设置，而不是拥有引擎的前提条件。
通用页面，只会产出通用配置。
配置质量完全取决于你提交了什么——品牌指南和术语列表能给代理足够具体的内容去提取；而一个营销首页几乎提取不出多少有效信息。来源类型 会说明应该把它指向哪些内容。
这就是预配带来的交换：你只需要发出一个请求，再稍等片刻，就能省去把已写下的知识重新转写一遍的工作——把它指向你已经有的内容，然后直接从一个已经配置好的引擎开始。下面这些页面，就是对这句话各部分的展开说明。
