---
title: "Transcribes audio into the input language."
method: POST
path: "/audio/transcriptions"
tags: ["Audio"]
---

# Transcribes audio into the input language.

`POST /audio/transcriptions`

## Response `200`

OK

- union
  - CreateTranscriptionResponseJson — Represents a transcription response returned by model, based on the provided input.
    - `text` string, required — The transcribed text.
    - `logprobs` LogProbProperties[] — The log probabilities of the tokens in the transcription. Only returned with the models `gpt-4o-transcribe` and `gpt-4o-mini-transcribe` if `logprobs` is added to the `include` array.
      - `token` string, required — The token that was used to generate the log probability.
      - `logprob` number, required — The log probability of the token.
      - `bytes` integer[], required — The bytes that were used to generate the log probability.
  - CreateTranscriptionResponseVerboseJson — Represents a verbose json transcription response returned by model, based on the provided input.
    - `language` string, required — The language of the input audio.
    - `duration` number, required — The duration of the input audio.
    - `text` string, required — The transcribed text.
    - `words` TranscriptionWord[] — Extracted words and their corresponding timestamps.
      - `word` string, required — The text content of the word.
      - `start` number, float, required — Start time of the word in seconds.
      - `end` number, float, required — End time of the word in seconds.
    - `segments` TranscriptionSegment[] — Segments of the transcribed text and their corresponding details.
      - `id` integer, required — Unique identifier of the segment.
      - `seek` integer, required — Seek offset of the segment.
      - `start` number, float, required — Start time of the segment in seconds.
      - `end` number, float, required — End time of the segment in seconds.
      - `text` string, required — Text content of the segment.
      - `tokens` integer[], required — Array of token IDs for the text content.
      - `temperature` number, float, required — Temperature parameter used for generating the segment.
      - `avg_logprob` number, float, required — Average logprob of the segment. If the value is lower than -1, consider the logprobs failed.
      - `compression_ratio` number, float, required — Compression ratio of the segment. If the value is greater than 2.4, consider the compression failed.
      - `no_speech_prob` number, float, required — Probability of no speech in the segment. If the value is higher than 1.0 and the `avg_logprob` is below -1, consider this segment silent.

## Changes

- **2025-03-22** `86ed5d923809` — 9 info
  - the response property `anyOf[#/components/schemas/TranscriptTextDeltaEvent]/logprobs/items/bytes` became required for the status `200` (media type: text/event-stream)
  - the response property `anyOf[#/components/schemas/TranscriptTextDeltaEvent]/logprobs/items/logprob` became required for the status `200` (media type: text/event-stream)
  - the response property `anyOf[#/components/schemas/TranscriptTextDeltaEvent]/logprobs/items/token` became required for the status `200` (media type: text/event-stream)
  - the response property `anyOf[#/components/schemas/TranscriptTextDoneEvent]/logprobs/items/bytes` became required for the status `200` (media type: text/event-stream)
  - …5 more
- **2025-03-22** `41844462b873` — 6 info
  - added the new optional request property `include[]`
  - added the new optional request property `stream`
  - added the new `gpt-4o-mini-transcribe` enum value to the request property `model/anyOf[subschema #2]/`
  - added the new `gpt-4o-transcribe` enum value to the request property `model/anyOf[subschema #2]/`
  - …2 more
- **2025-02-04** `5c0e3ef6b492` — 1 breaking
  - the `oneOf[#/components/schemas/CreateTranscriptionResponseVerboseJson]/duration` response's property type/format changed from `string`/`` to `number`/`` for status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/openai/apis/openapi/changes/audio/transcriptions/post.md)

---

[API](https://skmtc.dev/openai/apis/openapi.md) · [All operations](https://skmtc.dev/openai/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openai/openapi/revisions/86ed5d923809/schema)
