---
title: "Audio Transcriptions"
method: POST
path: "/v1/audio/transcriptions"
tags: ["Audio"]
---

# Audio Transcriptions

`POST /v1/audio/transcriptions`

Transcribes audio into the input language.

## Response `200`

Successful Response

- AudioTranscription
  - `id` string, required — A unique identifier for the audio transcription.
  - `text` string, required — The transcription text.
  - `model` string, required — The model used to generate the transcription.
  - `segments` Segment[], nullable — Diarized segments, only set when `response_format=diarized_json`.
    - `id` integer, required — A unique identifier for the segment.
    - `type` string — The type of the segment.
    - `text` string, required — The segment text.
    - `start` number, required — Start time of the segment in seconds.
    - `end` number, required — End time of the segment in seconds.
    - `speaker` string, nullable — Speaker label assigned by diarization, if available.
  - `usage` ApiSchemasUsageUsage
    - `prompt_tokens` integer — Number of prompt tokens (e.g. input tokens).
    - `completion_tokens` integer — Number of completion tokens (e.g. output tokens).
    - `total_tokens` integer — Total number of tokens (e.g. input and output tokens).
    - `cost` number — Total cost of the request.
    - `carbon` CarbonFootprintUsage
      - `kWh` CarbonFootprintUsageKWh
        - `min` number — Minimum carbon footprint in kWh.
        - `max` number — Maximum carbon footprint in kWh.
      - `kgCO2eq` CarbonFootprintUsageKgCO2eq
        - `min` number — Minimum carbon footprint in kgCO2eq (global warming potential).
        - `max` number — Maximum carbon footprint in kgCO2eq (global warming potential).
    - `impacts` ApiSchemasUsageEnvironmentalImpacts
      - `kWh` number — Carbon footprint in kWh.
      - `kgCO2eq` number — Carbon footprint in kgCO2eq (global warming potential).
    - `requests` integer — Number of model requests.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/betagouv/apis/opengatellm.md) · [All operations](https://skmtc.net/betagouv/apis/opengatellm/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/betagouv/opengatellm/revisions/0db3023472ef/schema)