---
title: "Translate text"
method: POST
path: "/v1/translate"
---

# Translate text

`POST /v1/translate`

Translate text from one language to another. Select the source and target languages, and get text in new language.

## Headers

- `X-Data-Retention` boolean

## Request body

- TranslationRequest
  - `source` string, nullable — An ISO 639 code of the language you're translating from
  - `target` string, required — An ISO 639 code of the language you want to translate to.
  - `text` string, required — The text to be translated.
  - `tone` 'neutral' | 'warm' | 'professional' | 'narration' — The tone of the translated text.
  - `formality` 'casual' | 'formal' — Whether to be `formal` or `casual`.

## Response `200`

Successful Response

- TranslationResponse
  - `request_id` string, uuid, required
  - `text` string, required

## Changes

- **2026-04-30** `345ddd9a88d1` — 12 breaking, 6 info
  - removed the enum value `am` of the request property `source`
  - removed the enum value `am` of the request property `target`
  - removed the enum value `en` of the request property `source`
  - removed the enum value `en` of the request property `target`
  - …14 more
- **2026-01-21** `9caec45089fb` — 2 breaking, 4 warning, 7 info
  - the request property `text` became required
  - request property `text` list-of-types was narrowed by removing types `null` from media type `application/json`
  - removed the request property `file_id`
  - removed the request property `instructions`
  - …9 more
- **2025-10-07** `62c455aac36a` — 7 info
  - added the new optional request property `file_id`
  - added the new optional request property `instructions`
  - added the new optional request property `model`
  - the request property `text` became optional
  - …3 more
- **2025-08-05** `5e0436ccb10d` — 2 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `OAuth2PasswordBearer` was removed from the API

[Change history](https://skmtc.dev/spi-tch/apis/spitch-api/changes/v1/translate/post.md)

---

[API](https://skmtc.dev/spi-tch/apis/spitch-api.md) · [All operations](https://skmtc.dev/spi-tch/apis/spitch-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spi-tch/spitch-api/revisions/345ddd9a88d1/schema)