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

# Speech to Text API

> Turn audio and video files into text with the speech-to-text model you pick (Whisper, Deepgram, ElevenLabs Scribe, AssemblyAI and more): one row per file with the transcript, the language, the duration, timestamped segments, the exact model version, its maker and the exact cost of that call. You pay exactly what each call costs at the model's own rate.

`POST /v1/data/ai/transcription/run`

**Pricing:** Metered: you pay exactly each call's cost at the selected model's rates (default OpenAI: Whisper Large V3 Turbo: the model's own rate).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**files** `string[]` *required*

Public URLs of the audio or video files to transcribe, one row per file. Each file is one call to the model.

Format e.g. `https://www.example.com`.

**model** `string` (default: openai/whisper-large-v3-turbo)

The speech-to-text model. Pick from the list (popular models first). Each model shows its own rate (per minute of audio, or per 1M tokens), and that is exactly what each call costs.

30 allowed values, for example `openai/whisper-large-v3-turbo` (OpenAI: Whisper Large V3 Turbo), `openai/gpt-transcribe` (OpenAI: GPT Transcribe), `openai/gpt-4o-mini-transcribe` (OpenAI: GPT-4o Mini Transcribe), `openai/whisper-large-v3` (OpenAI: Whisper Large V3), `deepgram/nova-3` (Deepgram: Nova-3), `elevenlabs/scribe-v2` (ElevenLabs: Scribe v2), `assemblyai/universal-3-6-pro` (AssemblyAI: Universal-3.6 Pro), `google/gemini-3.5-transcribe` (Google: Gemini 3.5 Transcribe), `google/chirp-3` (Google: Chirp 3), `mistralai/voxtral-small-transcribe-3-0` (Mistral: Voxtral Small Transcribe 3). Fetch the full list with `GET /v1/data/ai/transcription?expand=options`.

**language** `string`

The spoken language. Leave empty to detect it automatically.

52 allowed values, for example `af` (Afrikaans), `ar` (Arabic), `bg` (Bulgarian), `bn` (Bengali), `ca` (Catalan), `cs` (Czech), `cy` (Welsh), `da` (Danish), `de` (German), `el` (Greek). Fetch the full list with `GET /v1/data/ai/transcription?expand=options`.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/ai/transcription/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "files": [
      "https://github.com/openai/whisper/raw/main/tests/jfk.flac",
      "https://upload.wikimedia.org/wikipedia/commons/d/dd/Armstrong_Small_Step.ogg"
    ],
    "model": "openai/whisper-large-v3-turbo"
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/ai/transcription/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "files": [
        "https://github.com/openai/whisper/raw/main/tests/jfk.flac",
        "https://upload.wikimedia.org/wikipedia/commons/d/dd/Armstrong_Small_Step.ogg"
    ],
    "model": "openai/whisper-large-v3-turbo"
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/ai/transcription/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "files": [
    "https://github.com/openai/whisper/raw/main/tests/jfk.flac",
    "https://upload.wikimedia.org/wikipedia/commons/d/dd/Armstrong_Small_Step.ogg"
  ],
  "model": "openai/whisper-large-v3-turbo"
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one transcript, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `id` | ID | text |
| `fileUrl` | File URL | text |
| `transcript` | Transcript | text |
| `language` | Language | text |
| `durationSeconds` | Duration (Seconds) | number |
| `segments` | Segments | object\_array |
| `model` | Model | text |
| `provider` | Provider | text |
| `costUsd` | Cost (USD) | number |
| `error` | Error | text |
| `createdAt` | Created At | datetime |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "ai/transcription",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "segments": [
        {
          "start": 0.0,
          "end": 7.74,
          "text": "And so, my fellow Americans, ask not what your country can do for you."
        },
        {
          "start": 8.1,
          "end": 10.4,
          "text": "Ask what you can do for your country."
        }
      ],
      "fileUrl": "https://github.com/openai/whisper/raw/main/tests/jfk.flac",
      "provider": "OpenAI",
      "language": "en",
      "error": null,
      "model": "openai/whisper-large-v3-turbo",
      "id": "gen-stt-1794261162-L9QcCZh7srNpooqhL4r7",
      "transcript": "And so, my fellow Americans, ask not what your country can do for you.  Ask what you can do for your country.",
      "costUsd": 3.663e-05,
      "createdAt": "2026-11-09T21:52:45Z",
      "durationSeconds": 11.0
    }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.