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

# Audio Transcription

The `/v1/audio/transcriptions` API turns uploaded audio into text. For typical files it behaves as a **single request/response** (upload the file, get the transcript back).

## 1. The Request

**Method:** `POST`\
**Endpoint:** `https://api.sciforium.com/v1/audio/transcriptions`\
**Content-Type:** `multipart/form-data`

### Request body parameters

| Parameter                   | Type   | Required | Description                                                                                          |
| --------------------------- | ------ | -------- | ---------------------------------------------------------------------------------------------------- |
| `file`                      | file   | Yes      | Audio to transcribe. Common formats: mp3, mp4, m4a, wav, webm. Max **25 MB** (enforced server-side). |
| `model`                     | string | Yes      | Model ID your deployment supports (see your model list / console).                                   |
| `language`                  | string | No       | Language hint (ISO-639-1), e.g. `en`, `fr`, `es`.                                                    |
| `prompt`                    | string | No       | Optional hint for style, vocabulary, or domain terms.                                                |
| `response_format`           | string | No       | Output shape, e.g. `json`, `text`, `verbose_json`, `srt`, `vtt` (depends on model).                  |
| `timestamp_granularities[]` | array  | No       | For some models / formats (e.g. word or segment granularity in verbose output).                      |

### Example request (CURL)

```bash theme={null}
curl -X POST "https://api.sciforium.com/v1/audio/transcriptions" \
  -H "Authorization: Bearer $TOKEN" \
  -H "x-api-key: $TOKEN" \
  -F "file=@interview_audio.mp3" \
  -F "model=YOUR_MODEL_ID" \
  -F "response_format=json"
```

## 2. The response

Response shape depends on `response_format` and model support.

### Common response formats

| response\_format | Typical response                                                                             |
| ---------------- | -------------------------------------------------------------------------------------------- |
| `wav`            | Standard uncompressed WAV audio; best compatibility with tools/players.                      |
| `pcm`            | Raw 16-bit PCM audio bytes (typically 24kHz mono); best for low-latency streaming pipelines. |
| `opus`           | Compressed Opus audio; much smaller files with good speech quality.                          |

## Example response

### `response_format=wav`

```json theme={null}
{
  "format": "wav",
  "content_type": "audio/wav",
  "audio_base64": "UklGRiQAAABXQVZFZm10IBAAAAABAAEA..."
}
```

### `response_format=pcm`

```json theme={null}
{
  "format": "pcm",
  "content_type": "audio/octet-stream",
  "audio_base64": "kP8A/wD+AP0A/AD7APoA+QD4..."
}
```

### `response_format=opus`

```json theme={null}
{
  "format": "opus",
  "content_type": "audio/ogg",
  "audio_base64": "T2dnUwACAAAAAAAAAADY8kQeAAAAA..."
}
```