# Transcribe audio file

Uploads an audio file and returns the transcribed text using AI-powered speech recognition

Endpoint: POST /v1/transcribe/file
Version: 1.0.0
Security: bearerAuth

## Request fields (multipart/form-data):

  - `file` (string, required)
    Audio file to transcribe. Supported formats: mp3, mp4, m4a, wav, ogg, webm, flac, aac, pcm, opus. Maximum size: 200MB

## Response 200 fields (application/json):

  - `status` (string, required)
    Status of the transcription request
    Enum: "success", "error"

  - `success` (boolean, required)
    Whether the transcription was successful
    Example: true

  - `message` (string, required)
    Human-readable status message
    Example: "File uploaded successfully."

  - `text` (string,null)
    The transcribed text from the audio file
    Example: "Patient reports improvement in symptoms since last visit. Sleep quality has improved with the current medication regimen."

## Response 401 fields (application/json):

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (object)
    Detailed validation errors by field
    Example: {"email":["The email must be a valid email address","The email has already been taken"],"password":["The password must be at least 8 characters"],"template_name":["This field is required"]}

## Response 403 fields (application/json):

  - `status` (string, required)
    Status of the transcription request
    Enum: "success", "error"

  - `success` (boolean, required)
    Whether the transcription was successful
    Example: true

  - `message` (string, required)
    Human-readable status message
    Example: "File uploaded successfully."

  - `text` (string,null)
    The transcribed text from the audio file
    Example: "Patient reports improvement in symptoms since last visit. Sleep quality has improved with the current medication regimen."

## Response 422 fields (application/json):

  - `message` (string, required)
    Error message
    Example: "Validation failed"

  - `errors` (object)
    Detailed validation errors by field
    Example: {"email":["The email must be a valid email address","The email has already been taken"],"password":["The password must be at least 8 characters"],"template_name":["This field is required"]}


## Response 429 fields