Polytranslator

Polytranslator API

保留版式的文档翻译 API。 在 475 种语言和风格之间翻译 PDF（包括扫描件）、Word、PowerPoint、Excel、EPUB 和照片，其中包括古希腊语、科普特语和古英语等古代及资源稀缺语言。原生文档会保留其格式；照片会以 PNG 格式返回，其他受支持的输入则会转换为可编辑的文档格式。文本翻译、webhook 和供 AI Agent 使用的远程 MCP 服务共用预付费额度。REST 集成使用 API 密钥，或通过 OAuth 连接助手。无需订阅。

• 网站和定价：https://www.polytranslator.com/developers/
• 完整参考文档：https://www.polytranslator.com/developers/docs/（供 Agent 使用的 Markdown：https://www.polytranslator.com/api.md）
• OpenAPI：openapi.json（线上版本：https://www.polytranslator.com/api/openapi.json）
• MCP 服务：https://www.polytranslator.com/api/mcp
• 公开的 MCP 工具卡片：/.well-known/mcp/server-card.json
• 获取 API 密钥：https://www.polytranslator.com/api-keys/

快速入门

export POLYTRANSLATOR_API_KEY=pk_live_...
export IDEMPOTENCY_KEY=$(uuidgen) # Keep this value when retrying this submission.

# 1. Submit (returns 202 with a document id)
curl https://www.polytranslator.com/api/v1/documents \
  -H "Authorization: Bearer $POLYTRANSLATOR_API_KEY" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -F [email protected] -F tgt=spa_Latn -F max_credits=500

# 2. Set DOCUMENT_ID to the returned id, then wait (up to 60 s per request).
export DOCUMENT_ID=REPLACE_WITH_RETURNED_ID
curl "https://www.polytranslator.com/api/v1/documents/$DOCUMENT_ID?wait=60" \
  -H "Authorization: Bearer $POLYTRANSLATOR_API_KEY"

# Repeat step 2 while status is queued or processing.
# 3. Once status is completed, download the translated file.
curl -OJ https://www.polytranslator.com/api/v1/documents/$DOCUMENT_ID/file \
  -H "Authorization: Bearer $POLYTRANSLATOR_API_KEY"

可运行示例：

任务	Python	Node	curl
翻译文档	translate_document.py	translate-document.mjs	translate-document.sh
免费报价	quote_document.py
翻译文本	translate_text.py
验证 webhook	verify_webhook.py	verify-webhook.mjs

功能

输入格式	PDF（基于文本或扫描件）、DOCX、PPTX、XLSX、EPUB、PNG、JPG、WEBP、HEIC；DOC、ODT、RTF、TXT、Markdown、HTML、XML、SRT、VTT、TeX、Pages → DOCX；XLS、ODS、CSV、TSV、Numbers → XLSX；PPT、ODP、Keynote → PPTX；MOBI、AZW3、FB2 → DOCX
输出	原生 PDF、DOCX、PPTX、XLSX 和 EPUB 保留其格式；照片以 PNG 格式返回，转换后的输入使用上述格式。保留版式、表格和图片，并在原处翻译扫描件或照片中的文本（output=formatted）。也可选择仅输出译文（output=text）。
限制	50 MB、1,000 页 PDF、每份文档 1,000,000 个字符；每个账户最多可同时处理 5 份文档
语言和风格	475 个目录条目；自动检测源语言；GET /v1/languages
等级	fast 和 advanced（准确度最高）
价格	预付费额度包，价格从 $9.99（300 个额度）到 $99.99（5,000 个额度）。每份文档在付款前均可免费获取报价，并按报价准确扣费；处理失败的文档会退还费用。文本：每 1,000 个字符消耗 1 个额度（fast），或 3 个额度（advanced）。
异步处理	使用 ?wait= 长轮询，或在文档处理完成时通过签名 webhook（callback_url）通知
安全性	提交时使用 Idempotency-Key（重试不会重复扣费），并可通过 max_credits 设置每次请求的消费上限
Agent	无界面注册，并通过 Stripe Shared Payment Token 购买；支持 OpenAPI、llms.txt 和远程 MCP 服务

fast 等级下的实测示例：一份简短的 Word 合同耗费 1 个额度；一页扫描版法院文件耗费 19 个额度。

在 AI Agent 中使用（MCP）

远程 Streamable HTTP 服务，无需安装。工具：translate_document、get_document、quote_document、translate_text、list_languages、get_credit_balance。已完成的文档会以下载链接的形式返回，无需密钥即可在 24 小时内使用。

ChatGPT / Claude 网页连接器（OAuth）

在支持远程 MCP 和 OAuth 的客户端中，将 https://www.polytranslator.com/api/mcp 添加为自定义连接器或 MCP 服务。登录 Polytranslator 并批准连接。你无需将 API 密钥复制到助手中。连接器是否可用取决于你的客户端和账户设置。

每个连接都可以翻译文档和文本、读取已购买的额度余额，以及获取账户的 API 文档结果。它不能购买额度、更改账单设置或管理 API 密钥。文档和文本仍会消耗已购买的额度；批准连接不会购买额度包。你已启用的任何自动充值都会按现有设置继续运行。你可以在 API 仪表板中撤销名为 MCP: <client name> 的密钥，以撤销连接。

面向实现者：OAuth 使用 translation 作用域和带 S256 PKCE 的授权码流程。公共客户端可以使用 HTTPS 客户端 ID 元数据文档（CIMD），并设置 token_endpoint_auth_method: none。动态客户端注册（DCR）也继续支持公共客户端（none）和机密客户端（client_secret_basic 或 client_secret_post）。访问令牌有效期为 1 小时；刷新令牌会轮换，并在连接创建 30 天后过期。

资源地址必须为 https://www.polytranslator.com/api/mcp；请在授权请求和令牌请求中包含此地址。发行方为 https://www.polytranslator.com/api/oauth。发现端点为 /.well-known/oauth-protected-resource/api/mcp 和 /.well-known/oauth-authorization-server/api/oauth。

所有 MCP 传输请求（包括初始化和工具列表请求）都需要身份验证。缺少凭据或凭据无效时，会收到带有 WWW-Authenticate 发现质询的 HTTP 401 响应，以便客户端立即启动 OAuth。目录可以通过公共服务卡片查看这 6 个工具，无需登录。OAuth 访问令牌只能通过 MCP 使用；直接 REST 请求需使用 API 密钥。

API 密钥客户端

仍支持 API 密钥身份验证。以下配置使用 API 密钥；请勿将其提交到源代码管理中。REST 示例和 Postman 集合也使用 API 密钥。

Claude Code

claude mcp add --transport http polytranslator https://www.polytranslator.com/api/mcp \
  --header "Authorization: Bearer $POLYTRANSLATOR_API_KEY"

Cursor（.cursor/mcp.json）

{
  "mcpServers": {
    "polytranslator": {
      "url": "https://www.polytranslator.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code（.vscode/mcp.json）

{
  "servers": {
    "polytranslator": {
      "type": "http",
      "url": "https://www.polytranslator.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Codex（~/.codex/config.toml）

[mcp_servers.polytranslator]
url = "https://www.polytranslator.com/api/mcp"
bearer_token_env_var = "POLYTRANSLATOR_API_KEY"

注册表条目：mcp/server.json（com.polytranslator/translator）。也已列入 Smithery。

对比情况

与 DeepL、Google Cloud Translation、Azure AI Translator 和 Amazon Translate 的对比（格式、扫描件、限制、语言、定价、最低收费、设置）见 https://www.polytranslator.com/guides/document-translation-api/。

Postman

打开公开的 Postman 集合，或导入 postman/polytranslator.postman_collection.json，并将集合变量 apiKey 设置为你的 API 密钥。请对已填写的值保密；不要在公开的工作区或导出的集合中包含凭据。baseUrl 变量默认为 https://www.polytranslator.com/api。

关于

Polytranslator 由论文《From LLM to NMT: Advancing Low-Resource Machine Translation with Claude》的作者开发（Enis 和 Hopkins，2024 年，arXiv:2404.13813）。如有疑问，请联系：[email protected]。

本仓库中的示例采用 MIT 许可证。