API 文档
使用简洁的 REST API 程序化翻译 PDF。在设置中获取 API Key，几分钟内即可开始翻译 PDF。
认证方式
在请求中通过 Authorization 头（Bearer token）或 X-API-Key 头携带你的 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 Key 每分钟最多 60 次请求。每次响应均包含 X-RateLimit-Limit 和 X-RateLimit-Remaining 头。
定价说明
每页翻译消耗 10 积分。在 设置 → 积分 中查看余额。可购买积分包或订阅以定期获取积分。
常见问题
如何获取 PDF 翻译的 API Key？
在 translatepdfonline.com 注册账号，前往 设置 → API 密钥，点击「创建 API 密钥」。请立即复制密钥——关闭后将不再显示。
翻译 API 支持哪些语言？
API 支持 10 种语言：英语 (en)、中文 (zh)、西班牙语 (es)、法语 (fr)、意大利语 (it)、希腊语 (el)、日语 (ja)、韩语 (ko)、德语 (de)、俄语 (ru)。
使用 API 需要多少费用？
每页翻译消耗 10 积分。新用户赠送免费试用积分。可购买积分包或订阅月度套餐。
如何查询翻译任务状态？
提交翻译后你会获得 task_id。轮询 GET /api/tasks/{task_id} 查看状态（queued → processing → completed/failed）。
API 有速率限制吗？
是的，每个 API Key 每分钟限 60 次请求。超限将返回 429 响应。如需更高限额请联系我们。