Speech to English API¶

Translate audio from any language to English text with Amazon Transcribe + Translate or Amazon Bedrock audio-capable models through an OpenAI-compatible interface.

Why Choose the Speech to English API?¶

Quick Start: Available Endpoint¶

Feature Compatibility¶

Model Support¶

Amazon Models¶

Mistral Models¶

Other Amazon Bedrock Models¶

Any Amazon Bedrock model that accepts the SPEECH input modality through the Converse API can also translate audio out of the box: the gateway sends the audio together with a translation prompt and returns the model's English text output. Models whose speech input is only served by a bidirectional streaming API (e.g. amazon.nova-2-sonic) are not available on this route.

Advanced Features¶

Amazon Transcribe Features¶

Model & Features:

• Use amazon.transcribe with the same interface as OpenAI's Whisper API
• Or use OpenAI model names directly: whisper-1, gpt-transcribe, gpt-4o-transcribe, and gpt-4o-mini-transcribe work out of the box (they map to amazon.transcribe)
• Automatic transcription + translation pipeline in one request
• Multiple output formats: text, json, verbose_json, srt, vtt
• Automatic source language detection (zero configuration)
• Smart Subtitle Translation : Subtitle timing is preserved during translation

Note: With amazon.transcribe, the prompt and temperature parameters are rejected with an error to ensure consistent translation accuracy. Bedrock audio models accept both.

Provider-Specific Parameters¶

amazon.transcribe first transcribes the audio, then translates it, and each step has its own provider-specific parameters — both reachable via the same application/json request body.

Transcription step (Amazon Transcribe): the same extra parameters documented for /v1/audio/transcriptions (ContentRedaction, VocabularyName, VocabularyFilterName/VocabularyFilterMethod, ShowAlternatives/MaxAlternatives, ChannelIdentification, ToxicityDetection, IdentifyMultipleLanguages/LanguageOptions, ModelSettings) apply here too.

Translation step (Amazon Translate): Settings and TerminologyNames control the English output register and glossary:

{
  "model": "amazon.transcribe",
  "file": "data:audio/mp3;base64,<base64-encoded-audio>",
  "Settings": {
    "Formality": "FORMAL",
    "Profanity": "MASK"
  },
  "TerminologyNames": ["MyProductGlossary"]
}

• Settings.Formality (FORMAL or INFORMAL): Register of the translated text, for languages that support formality
• Settings.Profanity (MASK): Mask profane words and phrases in the translation
• Settings.Brevity (ON): Per AWS Translate, reduces the length of the translation output for most translations; unsupported language pairs silently ignore it
• TerminologyNames (list): Apply one or more custom terminologies (domain-specific glossaries) to the translation

Both settings apply consistently to the primary translated text and, for response_format=verbose_json, to every per-segment translation.

Invalid Settings values (e.g. an unsupported Formality) are rejected with HTTP 400 before any partial translation occurs.

Try It Now¶

Translate foreign audio to English text:

curl -X POST "$BASE/v1/audio/translations" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -F file=@spanish-interview.mp3 \
  -F model=amazon.transcribe \
  -F response_format=json

Translate via JSON body (MCP and AI agents):

When using MCP tools or HTTP clients that cannot construct multipart requests, pass the audio as a data URI or URL:

# Data URI (inline base64)
curl -X POST "$BASE/v1/audio/translations" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file": "data:audio/mp3;base64,<base64-encoded-audio>",
    "model": "amazon.transcribe"
  }'

# HTTPS URL (server fetches the audio)
curl -X POST "$BASE/v1/audio/translations" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file": "https://example.com/audio.mp3",
    "model": "amazon.transcribe"
  }'

# Files API reference (file-id: URI scheme)
curl -X POST "$BASE/v1/audio/translations" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file": "file-id:file-0190c51c7de7455d9b8c2efe27dfbf67",
    "model": "amazon.transcribe"
  }'

See Files API → Referencing Uploaded Files for the full description of the file-id: URI scheme.

Translate foreign audio to English subtitles:

curl -OJ -X POST "$BASE/v1/audio/translations" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -F file=@spanish-interview.mp3 \
  -F model=amazon.transcribe \
  -F response_format=srt

Ready to translate multilingual audio? Explore available models in the Models API.