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

# Create transcription

`POST /v1/audio/transcriptions`

## Request

- Base URL: `https://api.tokenlab.sh`
- URL: `https://api.tokenlab.sh/v1/audio/transcriptions`
- Auth: HTTP bearer

Transcribes audio into text (Speech-to-Text).

## Headers

- `X-TokenLab-Delivery-Policy` 'auto' | 'verified' | 'official'

## Response `200`

Successful response

- AudioTranscriptionResponse
  - `text` string: Transcribed text
  - `task` string
  - `language` string
  - `duration` number
  - `words` object[]
    - `word` string
    - `start` number
    - `end` number
  - `segments` object[]
    - `id` integer
    - `start` number
    - `end` number
    - `text` string

## Other responses

- `400`: Bad Request - Invalid input
- `401`: Unauthorized - Invalid or missing API key
- `402`: Payment Required - Insufficient balance or quota exceeded
- `429`: Rate Limit Exceeded
- `500`: Internal Server Error
- `503`: The requested Delivery tier is temporarily unavailable.

---

[API](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway.md) · [All operations](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/revisions/3208bfbcda22?raw)