Documentación API

Traduce PDFs programáticamente con nuestra sencilla API REST. Obtén una clave API desde tu configuración y comienza a traducir PDFs en minutos.

Autenticación

Incluye tu clave API en las solicitudes usando el encabezado Authorization (Bearer token) o X-API-Key. Crea y gestiona tus claves en Configuración → API Keys.

Endpoint

POST /api/v1/translate

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

Cuerpo de la solicitud

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

Límite de velocidad

Cada clave API está limitada a 60 solicitudes por minuto. Los encabezados de límite (X-RateLimit-Limit, X-RateLimit-Remaining) se incluyen en cada respuesta.

Precios

La traducción consume 10 créditos por página. Consulta tu saldo en Configuración → Créditos. Compra más créditos o suscríbete.

Preguntas Frecuentes

¿Cómo obtengo una clave API?

Regístrate en translatepdfonline.com, ve a Configuración → API Keys y haz clic en "Create API Key". Copia tu clave inmediatamente.

¿Qué idiomas soporta la API?

La API soporta 10 idiomas: inglés (en), chino (zh), español (es), francés (fr), italiano (it), griego (el), japonés (ja), coreano (ko), alemán (de) y ruso (ru).

¿Cuánto cuesta usar la API?

Cada página traducida consume 10 créditos. Los nuevos usuarios reciben créditos de prueba gratuitos.

¿Cómo verifico el estado de mi traducción?

Después de enviar una traducción, recibes un task_id. Consulta GET /api/tasks/{task_id} para verificar el estado.

¿Hay un límite de velocidad en la API?

Sí, cada clave API está limitada a 60 solicitudes por minuto. Si excedes este límite, recibirás una respuesta 429.