> ## Documentation Index
> Fetch the complete documentation index at: https://docs.darkbloom.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Transcribe audio files with Darkbloom's API

> POST /v1/audio/transcriptions transcribes audio to text using the OpenAI-compatible Whisper endpoint, served by attested Apple Silicon providers.

`POST /v1/audio/transcriptions` transcribes an audio file to text. The endpoint is compatible with the OpenAI Whisper API — you submit audio as a multipart form upload and receive a JSON response containing the transcript. Providers serving transcription run Whisper on Apple Silicon via the same hardened inference process used for text models.

## Request

The request must be sent as `multipart/form-data`.

<ParamField body="file" type="file" required>
  The audio file to transcribe. Common formats include MP3, MP4, MPEG, MPGA, M4A, WAV, and WEBM.
</ParamField>

<ParamField body="model" type="string" required>
  The transcription model to use. Pass `whisper-1` to use the default Whisper model available on the network.
</ParamField>

## Example

```bash curl theme={null}
curl https://api.darkbloom.dev/v1/audio/transcriptions \
  -H "Authorization: Bearer eigeninference-your-key-here" \
  -F "file=@recording.mp3" \
  -F "model=whisper-1"
```

## Response

```json theme={null}
{
  "text": "The transcript of the audio file appears here as a single string."
}
```

<ResponseField name="text" type="string">
  The transcribed text from the audio file.
</ResponseField>

<Note>
  Transcription requests are routed to providers that have a Whisper model loaded. If no transcription providers are currently online, the request will queue and retry up to three times before returning an error.
</Note>