Documentation API

Traduisez des PDF par programmation avec notre API REST simple. Obtenez une clé API dans vos réglages et lancez-vous en quelques minutes.

Authentification

Envoyez votre clé API via l'en-tête Authorization (Bearer token) ou X-API-Key. Créez et gérez vos clés dans Réglages → Clés API.

Endpoint

POST /api/v1/translate

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

Corps de la requête

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

Limites de débit

Chaque clé API est limitée à 60 requêtes par minute. Les en-têtes X-RateLimit-Limit et X-RateLimit-Remaining sont inclus dans chaque réponse.

Tarifs

La traduction consomme 10 crédits par page. Consultez votre solde dans Réglages → Crédits. Achetez des crédits ou abonnez-vous.

Questions fréquentes

Comment obtenir une clé API pour la traduction de PDF ?

Inscrivez-vous gratuitement sur translatepdfonline.com, puis créez une clé dans Réglages → Clés API. Copiez-la immédiatement.

Quelles langues l'API de traduction prend-elle en charge ?

L'API prend en charge 10 langues : français, anglais, chinois, espagnol, italien, grec, japonais, coréen, allemand et russe.

Combien coûte l'utilisation de l'API ?

Chaque page traduite coûte 10 crédits. Les nouveaux utilisateurs reçoivent des crédits d'essai gratuits.

Comment suivre l'état de ma traduction ?

Après l'envoi, vous recevez un task_id. Interrogez GET /api/tasks/{task_id} pour suivre l'état (queued → processing → completed/failed).

L'API a-t-elle des limites de débit ?

Oui, chaque clé API est limitée à 60 requêtes par minute. Au-delà, vous recevrez une réponse 429.