apicheats.dev openai/llms.txt Raw .md
POST

POST /audio/translations — OpenAI API

OpenAI API key (required); https://api.openai.com/v1

OpenAI API

Create 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

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.