POST
POST /audio/translations — OpenAI API
OpenAI API key (required); https://api.openai.com/v1
OpenAI APICreate translation
- Base URL
- https://api.openai.com/v1
- Auth
- Authorization: Bearer <OPENAI_API_KEY>
- Last verified
- 2026-10-20 · upstream hash matched
Actions Try in browser→
Agents: curl -H "Accept: text/markdown" this URL
→ 307 tokens · Vary: Accept
→ 307 tokens · Vary: Accept
Critical gotchas
The Responses API is the primary interface for new text and tool workflows; Chat Completions remains a separate compatibility API.
Audio transcription uploads use multipart form data rather than a JSON request body.
cURL
curl -X POST 'https://api.openai.com/v1/audio/translations' \ -H "Authorization: Bearer $OPENAI_API_KEY" \ -F '[email protected]' \ -F 'model=whisper-1'
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| file | body | string | Yes | The audio file object (not file name) translate, in one of these formats: flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, or webm. The request must include enough format metadata for the file to be identified. We recommend an extension-bearing filename and an appropriate content type. |
| model | body | string | Yes | ID of the model to use. Only `whisper-1` (which is powered by our open source Whisper V2 model) is currently available. |
| prompt | body | string | No | An optional text to guide the model's style or continue a previous audio segment. The [prompt](https://developers.openai.com/api/docs/guides/speech-to-text#prompting) should be in English. |
| response_format | body | string | No | The format of the output, in one of these options: `json`, `text`, `srt`, `verbose_json`, or `vtt`. |
| temperature | body | number | No | The sampling temperature, between 0 and 1. Higher values like 0.8 will make the output more random, while lower values like 0.2 will make it more focused and deterministic. If set to 0, the model will use [log probability](https://en.wikipedia.org/wiki/Log_probability) to automatically increase the temperature until certain thresholds are hit. |
Response 200 OK
{
"text": "string"
} Get a free OpenAI API key → sponsored Affiliate link - we may earn a commission, at no extra cost to you.