Skip to main content

Overview

Use /v1/translations for text-to-text translation.
This endpoint is different from Audio Translation, which accepts an audio file and always outputs English text.
For agent workflows, discover the current recommended translation models first:
Then explicitly send the chosen model to /v1/translations.
recommended_for=translation applies only to text translation (POST /v1/translations). It does not apply to audio translation.

Request Body

string
required
Translation model ID returned by /v1/models?recommended_for=translation.
string
required
Source text to translate.
string
required
Target language code or language name, depending on model support.
string
Optional source language hint.
string
default:"text/plain"
Source text format. Supported values: text/plain, text/html.
string
Optional end-user identifier for abuse monitoring and request tracing.

Response

string
Translated text.
string
Model that generated the translation.
string | null
Source language detected or accepted by the model.
string
Target language used for the request.