Cited PDF excerpt translation API
Translate selected source excerpts with citation identifiers and explicit partial-document coverage, using HQTools HQ-credit quotes.
Partial translation with exact source identifiers#
Obtain an active pdfhq.ai.translate HQTools tariff and create an account-scoped quantity-one quote. Submit POST /v1/ai/jobs with operation pdfhq.ai.translate, the immutable sealed upload, target_language (en/fr/de/es/pt/it/nl/pl/tr/id), allow_external_ai=true and a stable Idempotency-Key. The worker translates selected cited excerpts only, never the whole PDF, and validates every translated_excerpt citation against selected evidence. AI-generated translations require human review.
POST https://api.pdfhq.io/v1/ai/jobs
Idempotency-Key: STABLE_RANDOM_IDEMPOTENCY_KEY
{"operation":"pdfhq.ai.translate","upload_id":"UPLOAD_UUID",
"quote_id":"HQTOOLS_QUOTE_ID","target_language":"fr",
"question":"Translate the selected excerpts", "allow_external_ai":true}
GET https://api.pdfhq.io/v1/ai/jobs/AI_JOB_UUID
GET https://api.pdfhq.io/v1/ai/jobs/AI_JOB_UUID/evidence.csv