---
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

---

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