API 문서

간단한 REST API로 프로그램에서 PDF를 번역하세요. 설정에서 API 키를 발급받고 몇 분 안에 PDF 번역을 시작할 수 있습니다.

인증

Authorization 헤더(Bearer 토큰) 또는 X-API-Key 헤더로 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 헤더가 포함됩니다.

요금

페이지당 번역에 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 응답이 반환됩니다.