← API 接入指南与教程

使用术语库和记忆库

让新翻译沿用已确认的产品术语和历史译文。先按首次调用教程配置站点、密钥和客户端。术语库指定词语的译法,记忆库提供已确认的对译句段。是否复用取决于匹配规则,不保证每个句段都命中。

1. 查找可用资源

node simplifyai-translate/scripts/cli.mjs glossaries list
node simplifyai-translate/scripts/cli.mjs memories list
node simplifyai-translate/scripts/cli.mjs glossaries entries GLOSSARY_ID
node simplifyai-translate/scripts/cli.mjs memories entries MEMORY_ID

这些命令对应 GET /glossaries、GET /memories 及其 /{id}/entries 子路径。只返回当前账户有权使用的个人或团队资源。next_cursor 是不透明字符串。出现时用 --cursor 原样继续读取,不要把第一页当作全部结果。

2. 创建术语库并预览映射

保存 glossary.json,再创建个人术语库。重复创建会产生新库,所以响应丢失时先 list 查找,不要盲目重试。

{"name":"产品术语","entries":[{"translations":{"en":"water tank","de":"Wasserbehälter"}}]}
node simplifyai-translate/scripts/cli.mjs glossaries create --request glossary.json

将真实 ID 填入 resolve.json,然后预览英语到德语的映射。

{"glossary_ids":["<glossary_id>"],"source_lang":"en","target_lang":"de"}
node simplifyai-translate/scripts/cli.mjs glossaries resolve --request resolve.json

对应 POST /glossaries 和 POST /glossaries/resolve。API 不提供记忆库创建;请选择已经存在的记忆库。

不提供执行上限时,付费报价等待确认,零执行报价自动执行。CLI 的分析与确认上限均可省略:省略分析上限接受当前分析费;运行 jobs confirm JOB_ID 不带上限表示接受固定报价。

3. 为翻译选择库

将真实 ID 替换到命令中。成功分析会收费,本例最多授权 1 点分析费,先停在执行报价。

node simplifyai-translate/scripts/cli.mjs translate manual.docx --to de --glossary-ids GLOSSARY_ID --memory-ids MEMORY_ID --max-analysis-credits 1

HTTP 创建请求的 options 可以这样填写,预算字段与首次调用相同。

{"target_lang":"de","glossary_ids":["<glossary_id>"],"memory_ids":["<memory_id>"]}

恢复时重复同一命令。库 ID 是推导引用的一部分,换一组选择就是新任务。已创建任务的库选择可以在确认时修改,不能靠改变原命令参数更新。

4. 在确认时修改选择

需要调整时保存 review.json。空数组表示清空对应选择,省略字段沿用创建时的选择。

{"glossary_ids":["<glossary_id>"],"memory_ids":[]}
node simplifyai-translate/scripts/cli.mjs jobs confirm JOB_ID --max-credits 10 --review review.json

这是执行授权,10 点为本例的执行预算,必须在用户授权范围内。HTTP 调用将此对象放在 POST /jobs/{id}/confirmation 的 review 字段内。确认成功后不要用不同内容重放确认。服务端在确认时形成快照,之后修改库不会改变已开始的翻译。

5. 核验输出

等待完成并下载,检查术语是否符合预览映射,以及历史译文是否适合上下文。短句、格式差异或术语冲突可能只作为参考,不会强制替换。检查错误的匹配后,可通过审阅与重新生成修正译文。