Документация API

Переводите PDF программно с помощью простого REST API. Получите API-ключ в настройках и начните переводить PDF за пару минут.

Аутентификация

Передавайте API-ключ в заголовке Authorization (Bearer-токен) или X-API-Key. Создавайте и управляйте ключами в разделе Настройки → 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 включены в каждый ответ.

Цены

Перевод стоит 10 кредитов за страницу. Баланс можно посмотреть в Настройки → Кредиты. Кредиты можно купить или пополнять по подписке.

Часто задаваемые вопросы

Как получить API-ключ для перевода PDF?

Зарегистрируйтесь бесплатно на translatepdfonline.com, перейдите в Настройки → API-ключи и нажмите «Создать ключ». Сразу скопируйте ключ.

Какие языки поддерживает API перевода?

API поддерживает 10 языков: русский, английский, китайский, испанский, французский, итальянский, греческий, японский, корейский и немецкий.

Сколько стоит использование API?

Каждая переведённая страница стоит 10 кредитов. Новым пользователям выдаются бесплатные пробные кредиты.

Как проверить статус перевода?

После отправки перевода вы получаете task_id. Опрашивайте GET /api/tasks/{task_id}, чтобы узнать статус (queued → processing → completed/failed).

Есть ли лимиты на запросы к API?

Да, на каждый API-ключ действует лимит 60 запросов в минуту. При превышении вы получите ответ 429.