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 응답이 반환됩니다.