Profile
Manage your account and developer API tokens.
Change Password
Quick Access
Concurrency: Free=2, Pro/Team=3, VIP1=4, VIP2/VIP3 selectable 1-10. Output files named *_dual.pdf / *_mono.pdf.
VIP & Recharge
Loading recharge plans...
Direct self-recharge is disabled. Please use admin-provided recharge codes.
Billing History
Review recharge credits and translation charges.
| Time | Type | Usage | Amount | Details |
|---|---|---|---|---|
| Loading billing history... | ||||
Personal Access Tokens
0 active token(s). Default is permanent.
| Name | Prefix | Scopes | Last Used | Expires | Action |
|---|---|---|---|---|---|
| No API tokens yet. | |||||
Task Management
Cancel all queued or running translation tasks at once.
Programming API Quick Start
Use Authorization: Bearer YOUR_PAT for authentication. All endpoints require this header.
Parameter Reference
| Param | Required | Default | Description |
|---|---|---|---|
file | Yes | - | PDF file to upload |
engine | No | pdf2zh | Engine: pdf2zh or pdf2zh_next |
service | No | deepseek | LLM service: deepseek, openailiked, etc. |
sourceLang | No | en | Source language code, e.g. en, zh, zh-CN, ja, ko, fr |
targetLang | No | zh | Target language code, e.g. zh, en, ja, ko, de, es |
keyMode | No | system | API key mode: system / provider / user |
providerId | Cond. | - | Required when keyMode=provider, admin model ID |
credentialId | Cond. | - | Required when keyMode=user, user credential ID |
next_service | No | | Secondary LLM service (for dual-model) |
threadNum | No | 4 | Translation thread count (1-16) |
timeout | No | 1800000 | Timeout in ms, default 30 min |
Complete Workflow
# ============================================
# 1) Create translation task
# ============================================
# Option A: System key (keyMode=system)
curl -X POST "https://api.littranslate.me/api/v1/tasks" \
-H "Authorization: Bearer YOUR_PAT" \
-F "file=@/path/to/paper.pdf" \
-F "engine=pdf2zh_next" \
-F "service=openailiked" \
-F "sourceLang=en" \
-F "targetLang=zh" \
-F "threadNum=4" \
-F "timeout=1800000" \
-F "keyMode=system"
# Option B: Admin model (keyMode=provider)
curl -X POST "https://api.littranslate.me/api/v1/tasks" \
-H "Authorization: Bearer YOUR_PAT" \
-F "file=@/path/to/paper.pdf" \
-F "engine=pdf2zh_next" \
-F "service=openailiked" \
-F "sourceLang=en" \
-F "targetLang=zh" \
-F "threadNum=4" \
-F "timeout=1800000" \
-F "keyMode=provider" \
-F "providerId=<provider_id>"
# Option C: Your own key (keyMode=user)
curl -X POST "https://api.littranslate.me/api/v1/tasks" \
-H "Authorization: Bearer YOUR_PAT" \
-F "file=@/path/to/paper.pdf" \
-F "engine=pdf2zh_next" \
-F "service=openailiked" \
-F "sourceLang=en" \
-F "targetLang=zh" \
-F "threadNum=4" \
-F "timeout=1800000" \
-F "keyMode=user" \
-F "credentialId=<credential_id>"
# Response example:
# {"task_id":"<task_id>","status":"queued","message":"Task created"}
# ============================================
# 2) Poll task status (until completed or failed)
# ============================================
curl -H "Authorization: Bearer YOUR_PAT" \
"https://api.littranslate.me/api/v1/tasks/<task_id>"
# Response example:
# {"id":"...","status":"completed","progress":100,
# "files":[{"kind":"output","filename":"xxx_mono.pdf",...},
# {"kind":"output","filename":"xxx_dual.pdf",...}]}
# ============================================
# 3) Download output (filename from step 2 files list)
# ============================================
curl -L -H "Authorization: Bearer YOUR_PAT" \
"https://api.littranslate.me/api/v1/tasks/<task_id>/download/<filename>" \
-o translated.pdf
# ============================================
# 4) Other endpoints
# ============================================
# List all tasks
curl -H "Authorization: Bearer YOUR_PAT" \
"https://api.littranslate.me/api/v1/tasks"
# Cancel a task
curl -X POST -H "Authorization: Bearer YOUR_PAT" \
"https://api.littranslate.me/api/v1/tasks/<task_id>/cancel"
# Delete a finished task
curl -X DELETE -H "Authorization: Bearer YOUR_PAT" \
"https://api.littranslate.me/api/v1/tasks/<task_id>"
# List available admin models
curl -H "Authorization: Bearer YOUR_PAT" \
"https://api.littranslate.me/api/v1/providers"