PageTranslate Document Translator
Use this skill whenever the user wants a Word document or business file translated and returned as the same kind of file: DOCX contracts, manuals, HR policies, marketing material, financial reports, CVs. Keeps headings, tables, lists and images. Shows the exact price first.
PageTranslate Document Translator
Translate a Word document or business file with PageTranslate: a DOCX comes back as a DOCX, with its headings, tables, lists and images.
PageTranslate translates the file itself, not pasted text. For a sentence or a paragraph, translate it yourself.
When to use
- The user names a
.docxfile, or a business document in PDF, and a language. - The document must stay editable or keep its formatting: contracts, manuals, policies, reports, CVs.
- Several documents need the same treatment. Upload them one at a time.
Before you start
- Target language: a code such as
es,fr,de,it,ja,ko,ar,hi,ru. Usept-BRfor Brazilian Portuguese,zhfor Simplified andzh-TWfor Traditional Chinese. The source language is detected. If the user did not name a target language, ask. - API key: the user creates one at https://pagetranslate.ai/dashboard/api-keys (free account, verified
email) and sets it as
PAGETRANSLATE_API_KEY. - Price: uploading is free and returns the exact price. Nothing is charged until the user pays.
- Limits: PDF, DOCX, EPUB, PNG, JPG, WEBP, TIFF, BMP, GIF. Up to 100 MB and 1,000 PDF pages.
Steps
Use the pagetranslate MCP tools when they are available. Otherwise use curl (next section).
- Upload:
upload_documentwith the file's absolute path and the target language. It returnsjob_id,word_count,priceandnext_step. - Tell the user the price and get a yes. Then:
- If the response has a
payment_url, give the user that link. They pay by card in the browser, and the translation starts by itself. - If the price is
0.00(covered by the account's word balance), callstart_translation.
- If the response has a
- Wait: call
get_translationabout every 30 seconds untilstatusiscompleted. Ifstatusisfailed, tell the user the reason given. - Download:
download_translationwithoutput_dirset to the source file's folder. It never overwrites a file. Tell the user the saved path.
list_translations shows earlier jobs, for example to download one again.
Without the MCP server
Same steps over HTTPS. Every request carries Authorization: Bearer $PAGETRANSLATE_API_KEY.
API=https://api.pagetranslate.ai/api/v1
# 1. Upload (free). The response has job_id and quote.total_cents.
curl -sS -X POST "$API/upload/" -H "Authorization: Bearer $PAGETRANSLATE_API_KEY" \
-F "file=@/path/to/file" -F "requested_language=es"
# 2. Start from the account's word balance. A 400 "Insufficient credits" means the user
# pays by card at https://pagetranslate.ai/dashboard?resume=JOB_ID#upload instead.
curl -sS -X POST "$API/jobs/JOB_ID/translate" -H "Authorization: Bearer $PAGETRANSLATE_API_KEY" \
-H "Content-Type: application/json" -d '{}'
# 3. Poll until "status" is "completed" ("payment_status" shows whether it was paid).
curl -sS "$API/jobs/JOB_ID" -H "Authorization: Bearer $PAGETRANSLATE_API_KEY"
# 4. Download. -OJ keeps the server's file name; run it in the folder to save into.
curl -sS -OJ "$API/jobs/JOB_ID/download" -H "Authorization: Bearer $PAGETRANSLATE_API_KEY"
Document notes
- Old
.docfiles are not accepted. Ask the user to save the file as.docxfirst. - This is an AI translation for working and reference use. It is not a certified translation. If the user needs one for immigration, a court or a government office, say so.
- Uploads are rate limited per account. For a folder of files, upload, quote and confirm each one in turn.
Problems
- 401: the key is missing or revoked. Ask the user to create a new one.
- 429 on upload: uploads are rate limited per account. Wait, do not retry in a loop.
- "Unsupported language code": use one of the codes above.
- Stuck at
pending: the job is unpaid. Give the user the payment link again.
Links
- Online version: document translation software
- Word files: DOCX translator
- Guide: how to translate a Word document
- Legal: translation software for legal documents
- Manuals: manufacturing document translations
- English and Spanish: translate English to Spanish documents
- Resumes: CV translator
- Source and docs: GitHub · npm · PageTranslate
Safety
- Uploading sends the file to PageTranslate. Upload only the file the user asked to translate.
- Never print the API key or write it to a file.
- Do not say a translation is running until
payment_statusispaid. - Never pay, or enter card details, for the user. Payment is theirs to make in the browser.
- Downloads
- 157All time
- Security audit
- Pass
- Last updated
- 1w ago
- Current version
- v0.1.3
- License
- MIT-0
