API ドキュメント

シンプルなREST APIでPDF翻訳をプログラムから実行。設定画面でAPIキーを取得すれば、数分でPDF翻訳を自動化できます。

認証

Authorizationヘッダー(Bearerトークン)またはX-API-KeyヘッダーでAPIキーを送信します。APIキーの作成・管理は 設定 → APIキー で行えます。

エンドポイント

POST /api/v1/translate

https://translatepdfonline.com/api/v1/translate

リクエストボディ

{
  "document_id": "string (required)",
  "source_lang": "string (required) — en|zh|es|fr|it|el|ja|ko|de|ru",
  "target_lang": "string (required) — en|zh|es|fr|it|el|ja|ko|de|ru",
  "page_range": "string (optional) — e.g. '1-10' or '5'"
}

cURL

curl -X POST https://translatepdfonline.com/api/v1/translate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document_id": "doc_xxx",
    "source_lang": "en",
    "target_lang": "zh",
    "page_range": "1-10"
  }'

Python

import requests

url = "https://translatepdfonline.com/api/v1/translate"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "document_id": "doc_xxx",
    "source_lang": "en",
    "target_lang": "zh",
    "page_range": "1-10"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())  # {"task_id": "...", "status": "queued"}

Node.js

const response = await fetch(
  "https://translatepdfonline.com/api/v1/translate",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      document_id: "doc_xxx",
      source_lang: "en",
      target_lang: "zh",
      page_range: "1-10"
    })
  }
);

const data = await response.json();
console.log(data); // { task_id: "...", status: "queued" }

レート制限

APIキーごとに毎分60リクエストまで。すべてのレスポンスにX-RateLimit-LimitとX-RateLimit-Remainingヘッダーが含まれます。

料金

1ページの翻訳につき10クレジットを消費します。残高は 設定 → クレジット で確認できます。クレジットの購入やサブスクリプションでの自動補充も可能です。

よくある質問

PDF翻訳APIのキーはどうやって取得できますか?

translatepdfonline.comで無料登録し、設定 → APIキー から「APIキーを作成」をクリックします。キーは作成直後に必ずコピーしてください。

翻訳APIはどの言語に対応していますか?

日本語・英語・中国語・スペイン語・フランス語・イタリア語・ギリシャ語・韓国語・ドイツ語・ロシア語の10言語に対応しています。

APIの利用料金はいくらですか?

翻訳1ページにつき10クレジット。新規登録で無料のトライアルクレジットが付与されます。

翻訳の処理状況はどう確認できますか?

翻訳を送信するとtask_idが返されます。GET /api/tasks/{task_id} で状況(queued → processing → completed/failed)を確認できます。

APIにレート制限はありますか?

はい、APIキーごとに毎分60リクエストまでです。上限を超えると429レスポンスが返ります。