---
title: "Translate text"
method: POST
path: "/translate/text"
tags: ["Media AI — Translation"]
---

# Translate text

`POST /translate/text`

## Request

- Base URL: `https://api.paperoffice.ai/latest`
- URL: `https://api.paperoffice.ai/latest/translate/text`
- Auth: HTTP bearer

## Request body

- object
  - `text` string, required: Text to translate: send as JSON string, string[], or object in the raw body (see Input types in docs).
  - `source_language` string: Source language code or auto for detection.
  - `target_language` string, required: Target language code (required). Must be one of the 35 supported codes.
  - `target_locale` string: Optional regional variant (e.g. de-AT, en-GB). From GET /translate/languages → data.target_locale.variants. Prompt hint only.
  - `tier` 'basic' | 'premium' | 'ultra': Quality tier: basic (fast), premium (balanced), ultra (best).
  - `preserve_terms` string[]: String, string[], or object keys kept verbatim on all tiers (basic/premium/ultra). Up to 150 unique terms (1–100 chars each). HTTP 400 PRESERVE_TERMS_LIMIT beyond that.
  - `preserve_terms_preset` string: Optional server preset merged with preserve_terms, e.g. paperoffice_brand.
  - `client_wait` boolean: true = inline translation. false or async_only=true = immediate job_id; poll GET /job/get/{job_id} until job_status is completed.
  - `async_only` boolean: Force immediate job_id (same as client_wait=false). optional JSON body field.

## Response `200`

Success

- SuccessEnvelope: Success envelope. Payload fields are endpoint-specific (top-level fields, `result`/`job_result` for jobs, `data` on some account endpoints).
  - `status` 'success', required
  - `processing_time` union
    - string
    - number
  - `_billing` object

## Other responses

- `202`: Accepted — job continues in the background
- `4XX`: Error
- `5XX`: Error

---

[API](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api.md) · [All operations](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/revisions/c6a6228a4509?raw)