Polytranslator

Polytranslator API

レイアウトを保ったまま翻訳できるドキュメント翻訳 API です。 PDF（スキャンを含む）、Word、PowerPoint、Excel、EPUB、写真を、古代ギリシャ語、コプト語、古英語などの古代語やリソースの少ない言語を含む475言語とスタイルに対応して翻訳します。元のドキュメント形式に対応している文書はその形式を保ち、写真は PNG で返されます。その他の対応入力形式は編集可能なドキュメント形式に変換されます。テキスト翻訳、Webhook、AI エージェント向けリモート MCP サーバーでは、同じ前払いクレジットを使用します。REST 連携には API キーを使用するか、OAuth でアシスタントを接続してください。サブスクリプションは不要です。

• ウェブサイトと料金：https://www.polytranslator.com/developers/
• 詳細なリファレンス：https://www.polytranslator.com/developers/docs/（エージェント向け Markdown：https://www.polytranslator.com/api.md）
• OpenAPI：openapi.json（稼働中の URL：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、PDF 1,000ページ、ドキュメントあたり1,000,000文字；アカウントあたり処理中のドキュメントは5件
言語とスタイル	カタログに475項目を収録；原文の言語は自動検出；GET /v1/languages
ティア	fast および advanced（最も高精度）
料金	300クレジットで9.99ドルから、5,000クレジットで99.99ドルまでの前払いクレジットパックをご用意しています。各ドキュメントは支払い前に無料で見積もられ、見積もり額のみが請求されます。失敗したドキュメントの料金は返金されます。テキスト翻訳は1,000文字あたり1クレジット（fast）、3クレジット（advanced）です。
非同期処理	?wait= によるロングポーリング、またはドキュメントの処理完了時に呼び出される署名付き Webhook（callback_url）
安全性	送信時の Idempotency-Key（再試行しても二重請求されません）、リクエストごとの支出上限 max_credits
エージェント	Stripe Shared Payment Token によるヘッドレスの登録と購入、OpenAPI、llms.txt、リモート MCP サーバー

fast ティアでの実測例：短い Word 契約書は1クレジット、スキャンされた1ページの裁判所提出書類は19クレジットです。

AI エージェントから利用する（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 を使用する認可コードフローを使用します。パブリッククライアントでは、token_endpoint_auth_method: none を指定した HTTPS Client ID Metadata Document（CIMD）を使用できます。パブリッククライアント（none）と機密クライアント（client_secret_basic または client_secret_post）では、動的クライアント登録（DCR）も引き続き利用できます。アクセストークンの有効期間は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 ライセンスで提供されています。