---
title: "Transcribe Audio to Text"
method: POST
path: "/v1/audio_transcribe"
---

# Transcribe Audio to Text

`POST /v1/audio_transcribe`

## Request

- Base URL: `https://api.musicgpt.com/api/public`
- URL: `https://api.musicgpt.com/api/public/v1/audio_transcribe`
- Auth: API key in header `Authorization`

Processes an audio file to generate a transcription of the spoken content with support for language detection, translation, and multiple output formats.

## Request body `multipart/form-data`

- union
  - object
    - `audio_url` string, required: Input audio URL (supported format: YouTube URL).
    - `audio_file` string, binary: Audio file to upload and process directly.
    - `language` string: Language spoken in the audio (empty for auto-detection).
    - `translate` boolean: Whether to translate the transcription to English.
    - `transcription_format` 'plain_text' | 'formatted_text' | 'srt' | 'vtt': Format of the transcribed output.
    - `translation_format` 'plain_text' | 'formatted_text' | 'srt' | 'vtt': Format of the translated output (currently unused).
    - `word_timestamps` boolean: Whether to include word-level timestamps.
    - `webhook_url` string: Callback URL for async processing results.
  - object
    - `audio_url` string: Input audio URL (supported format: YouTube URL).
    - `audio_file` string, binary, required: Audio file to upload and process directly.
    - `language` string: Language spoken in the audio (empty for auto-detection).
    - `translate` boolean: Whether to translate the transcription to English.
    - `transcription_format` 'plain_text' | 'formatted_text' | 'srt' | 'vtt': Format of the transcribed output.
    - `translation_format` 'plain_text' | 'formatted_text' | 'srt' | 'vtt': Format of the translated output (currently unused).
    - `word_timestamps` boolean: Whether to include word-level timestamps.
    - `webhook_url` string: Callback URL for async processing results.

## Response `200`

Successfully initiated transcription

- object
  - `success` boolean
  - `task_id` string
  - `conversion_id` string
  - `eta` integer
  - `credit_estimate` number, float
  - `message` string

## Other responses

- `422`: Validation Error
- `500`: Server Error

---

[API](https://skmtc.dev/musicgpt/apis/musicgpt-api.md) - [All operations](https://skmtc.dev/musicgpt/apis/musicgpt-api/llms.txt) - [OpenAPI document](https://skmtc.dev/musicgpt/apis/musicgpt-api/revisions/6753dccf4c5d?raw)