API-Dokumentation

Übersetzen Sie PDFs programmatisch mit unserer einfachen REST API. API-Key in den Einstellungen erstellen und in wenigen Minuten loslegen.

Authentifizierung

Senden Sie Ihren API-Key über den Authorization-Header (Bearer-Token) oder den X-API-Key-Header. Erstellen und verwalten Sie Keys unter Einstellungen → API-Schlüssel.

Endpoint

POST /api/v1/translate

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

Request-Body

{
  "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" }

Ratenlimit

Jeder API-Key ist auf 60 Anfragen pro Minute begrenzt. Jede Antwort enthält die Header X-RateLimit-Limit und X-RateLimit-Remaining.

Preise

Die Übersetzung kostet 10 Credits pro Seite. Guthaben unter Einstellungen → Credits einsehen. Credits kaufen oder Abo abschließen.

Häufige Fragen

Wie bekomme ich einen API-Key für die PDF-Übersetzung?

Registrieren Sie sich kostenlos auf translatepdfonline.com und erstellen Sie unter Einstellungen → API-Schlüssel einen neuen Key. Kopieren Sie ihn sofort.

Welche Sprachen unterstützt die Übersetzungs-API?

Die API unterstützt 10 Sprachen: Deutsch, Englisch, Chinesisch, Spanisch, Französisch, Italienisch, Griechisch, Japanisch, Koreanisch und Russisch.

Was kostet die Nutzung der API?

Jede übersetzte Seite kostet 10 Credits. Neue Nutzer erhalten kostenlose Test-Credits. Credits kaufen oder per Abo nachladen.

Wie prüfe ich den Status meiner Übersetzung?

Nach dem Absenden erhalten Sie eine task_id. Rufen Sie GET /api/tasks/{task_id} auf, um den Status zu prüfen (queued → processing → completed/failed).

Gibt es ein Ratenlimit für die API?

Ja, jeder API-Key ist auf 60 Anfragen pro Minute begrenzt. Bei Überschreitung erhalten Sie eine 429-Antwort.