一个产品。几个可移动的部件。这里是介绍。
每个部分都链接到更详细的页面,如果你想了解完整的故事。
一个端点,三种输入格式,一个UUID用于认证。
POST /ai_agent/translate 处理文本、HTML 和 JSON。 你选择输入格式、目标语言,以及是否希望同步返回答案或作为批处理任务。 那是整个表面积。
认证信息是放在授权头中的单一UUID。 无需交换令牌,无需客户端库即可开始使用。 curl 运行正常。n8n 运行正常。一个 LangChain 工具正常工作。 无论你拿着什么,都有效。
curl -X POST https://api.fluentc.io/ai_agent/translate \ -H "Authorization: 4f3a-uuid-...-9c2e" \ -H "Content-Type: application/json" \ -d '{ "input_format": "json", "target_language": "es", "mode": "sync", "content": { "title": "Hello", "body": "Welcome" } }' # 204ms · 200 OK { "translation": { "title": "Hola", "body": "Bienvenido" }, "target_language": "es", "tm_hit": false, "request_id": "tx_8f3a72c4" }
当代理人在对话中途,急需答案时。
同步请求,响应中包含翻译文本,无需轮询。
在幕后,有一个基于内容地址的缓存,其键为 SHA256(target_language + input)第二次遇到相同的字符串时,你完全跳过模型——相同的翻译、相同的键,响应更快。
这比听起来应该的重要得多。 多语言聊天机器人回答 你好 在十二种语言中,将不断访问该缓存。
当你有50,000行数据并且需要一次性全部导入时。
提交任务,获得一个 job_id 回来,准备好后进行投票以获取结果。 适用于Google表格、产品目录、JSON国际化文件目录——任何东西。
JSON处理得当:嵌套结构被遍历,每个字符串值都被独立且并行地翻译,最后重新组合成原始的结构。 钥匙仍然是钥匙。 结构仍然是结构。
一样 job_id 永远投票是安全的——它是一个 你的输入的确定性哈希,不是随机的票。 重新提交相同的内容,你会得到相同的job_id和相同的缓存结果。
一次付费,永久添加到购物车。
翻译记忆库是一个包含你已支付过的翻译内容的数据库。 下次遇到相同的字符串时,你无需再次支付——而且响应会更快,因为它不会调用模型。
大多数翻译API每次都按字符收费。 我们不。 对于电子商务目录、支持宏以及任何具有重复字符串的产品,这就是大部分节省的来源。
你也可以 在每个站点基础上覆盖特定的翻译 当你想要不同于模型默认的渲染效果时。 缓存会遵循您的覆盖设置。
你所期望的目录,依据询问的代理而定。
主要的欧洲语言、主要的亚洲语言、阿拉伯语、希伯来语、印地语,以及更为边缘的语言。
该列表已被缓存并在以下位置公开 GET /ai_agent/languages,范围限定在您在代理上启用的内容。
在您的仪表盘上添加或删除语言。 每个代理都有自己的启用集——因此,一个将内容翻译成十种语言的Shopify代理和一个内部支持代理翻译成三种语言的代理可以共存在同一个账户下。
如果你在进行评估,有五件事值得了解。
相同输入 + 目标语言为缓存命中。 没有“模糊匹配”的意外,也没有对重复字符串的每次调用计费。
重新提交相同的批次输入会返回相同的job_id。 设计上的幂等性
背景翻译任务在模型超时(5次尝试,指数退避)和速率限制(10次尝试,遵守Retry-After)时会重试。 你不必自己构建这个。
包含200个字符串值的文档不会进行200次连续的模型调用——它会扩散开来并重新组合。
整个API都可以通过curl访问。 如果你需要,SDK就存在;它们不是先决条件。
OpenAPI 规范已发布在 /ai_agent/swagger.yml 以及交互式文档在 /ai_agent/docs.