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

# Create Audio Transcription

`POST /api/v1/audio/transcriptions`

## Request

- The document declares no server URL.
- Auth: API key in header `Authorization`

Transcribe audio file to text.

This endpoint transcribes audio files using the Morpheus Network providers.
It automatically manages sessions and routes requests to the appropriate transcription model.

Supports both file upload and S3 pre-signed URLs.
Returns JSON or plain text responses based on response_format parameter.

## Request body `multipart/form-data`

- BodyCreateAudioTranscriptionApiV1AudioTranscriptionsPost
  - `file` string, binary: Audio file to transcribe
  - `s3_presigned_url` string: Pre-signed S3 URL as alternative to file upload
  - `prompt` string: Optional text to guide transcription
  - `temperature` number: Sampling temperature (0.0-1.0)
  - `language` string: Language code (e.g., 'en')
  - `response_format` string: Response format: json, text, srt, verbose_json, vtt
  - `timestamp_granularities` string: Comma-separated: word, segment
  - `output_content` string: Output content type
  - `enable_diarization` boolean: Enable speaker diarization
  - `session_id` string: Session ID (auto-created if not provided)
  - `model` string: Model name

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-05-22** `6059f99c1875`: 1 info
  - endpoint added
- **2026-01-14** `7c181edf9cbb`: 1 breaking
  - api path removed without deprecation
- **2025-12-17** `f26fcc0d5dc5`: 11 info
  - the `response_format` request property default value `json` was removed
  - request property `enable_diarization` list-of-types was widened by adding types `null` to media type `multipart/form-data`
  - request property `language` list-of-types was widened by adding types `null` to media type `multipart/form-data`
  - request property `model` list-of-types was widened by adding types `null` to media type `multipart/form-data`
  - …7 more
- **2025-12-17** `4eadcd19552d`: 10 breaking, 1 info
  - request property `enable_diarization` list-of-types was narrowed by removing types `null` from media type `multipart/form-data`
  - request property `language` list-of-types was narrowed by removing types `null` from media type `multipart/form-data`
  - request property `model` list-of-types was narrowed by removing types `null` from media type `multipart/form-data`
  - request property `output_content` list-of-types was narrowed by removing types `null` from media type `multipart/form-data`
  - …7 more
- **2025-12-17** `f26fcc0d5dc5`: 1 breaking
  - request body became required

[Operation history](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/changes/api/v1/audio/transcriptions/post.md)

---

[API](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway.md) - [All operations](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/revisions/6059f99c1875?raw)