ElevenLabs SDK-compatible STT (file upload)

POST/el/v1/speech-to-text

Transcribes an uploaded audio file with client.speechToText.convert(...). Supported formats are WAV, MP3, FLAC, MP4/M4A, OGG, and WebM. Unsupported or unreadable files return 422 indeterminate_audio_duration.

Use provider_options for provider-specific settings. You can also pass supported options directly as query parameters. If both forms set the same option, provider_options[<name>]=<value> takes precedence. Recognized enum and boolean option values are case-insensitive and are normalized to each provider's wire spelling; free-form values such as prompts, keyterms, and voice IDs retain their original case.

Authorization

xi-api-key<token>

Tenant key (ElevenLabs SDK convention).

In: header

Query Parameters

provider_order?array<string>

Comma-separated or repeated provider IDs in preferred order. Providers not listed remain eligible.

provider_only?array<string>

Comma-separated or repeated provider IDs. Only these providers may serve the request.

provider_ignore?array<string>

Comma-separated or repeated provider IDs that must not serve the request.

allow_fallbacks?boolean

Set to false to prevent fallback to another provider. Automatic provider retries are not currently supported.

provider_options?|||||||||||

Provider-specific options in bracket notation, such as provider_options[encoding]=linear16. You can also pass supported options directly as query parameters. If both forms set the same option, the bracketed value takes precedence.

Request Body

multipart/form-data

TypeScript Definitions

Use the request body type in TypeScript.

Audio file and transcription options.

file*file

Audio file to transcribe. Supported formats: WAV, MP3, FLAC, MP4/M4A, OGG, and WebM.

Formatbinary

model_id*string

Model id: bare name or {author}/{modelName} slug (e.g. elevenlabs/scribe_v2). Required — a missing value is refused 400 model_required; the router applies no default model.

language_code?string

Expected language.

timestamps_granularity?string

Timestamp detail to include in the response.

Default"word"

Value in

"none"
"word"
"character"

diarize?string

Set to true or 1 to enable speaker diarization.

provider?string

Provider preferences as a JSON string.

provider_options?string

Provider-specific options as a JSON string.

[key: string]?unknown

Response Body

`application/json`

import { open } from "node:fs/promises";const file = await open("call.wav");const form = new FormData();form.set("file", new Blob([await file.readFile()], { type: "audio/wav" }), "call.wav");form.set("model_id", "deepgram/nova-3");form.set("timestamps_granularity", "word");const response = await fetch("https://api.allmodels.io/el/v1/speech-to-text", {  method: "POST",  headers: { Authorization: `Bearer ${process.env.ALLMODELS_API_KEY}` },  body: form});if (!response.ok) throw new Error(`AllModels request failed: ${response.status}`);console.log(await response.json());

import osimport requestswith open("call.wav", "rb") as audio:    response = requests.post(        "https://api.allmodels.io/el/v1/speech-to-text",        headers={"Authorization": f"Bearer {os.environ['ALLMODELS_API_KEY']}"},        files={"file": ("call.wav", audio, "audio/wav")},        data={"model_id": "deepgram/nova-3", "timestamps_granularity": "word"},        timeout=120,    )response.raise_for_status()print(response.json())

curl -X POST https://api.allmodels.io/el/v1/speech-to-text \  -H "Authorization: Bearer $ALLMODELS_API_KEY" \  -F "file=@call.wav" \  -F "model_id=deepgram/nova-3" \  -F "timestamps_granularity=word"

import { File } from "node:buffer";import { readFile } from "node:fs/promises";import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";const client = new ElevenLabsClient({  apiKey: process.env.ALLMODELS_API_KEY,  baseUrl: "https://api.allmodels.io/el"});const bytes = await readFile("call.wav");const transcript = await client.speechToText.convert({  file: new File([bytes], "call.wav", { type: "audio/wav" }),  modelId: "scribe_v2",  timestampsGranularity: "word"});console.log(transcript.text);

import osfrom elevenlabs.client import ElevenLabsclient = ElevenLabs(    api_key=os.environ["ALLMODELS_API_KEY"],    base_url="https://api.allmodels.io/el",)with open("call.wav", "rb") as audio:    transcript = client.speech_to_text.convert(        file=audio,        model_id="scribe_v2",        timestamps_granularity="word",    )print(transcript.text)

{  "language_code": "en",  "language_probability": 0.98,  "text": "Hello from AllModels.",  "words": [    {      "text": "Hello",      "start": 0,      "end": 0.4,      "type": "word"    }  ]}

{  "detail": {    "message": "invalid multipart body",    "status": "invalid_multipart"  }}

{  "error": "missing_api_key"}

{  "detail": {    "message": "this organization has insufficient prepaid balance",    "status": "insufficient_balance"  }}

{  "error": "tenant_disabled"}

{  "detail": {    "loc": [      "body",      "file"    ],    "msg": "field required",    "type": "value_error.missing"  }}

{  "detail": {    "message": "provider 'example-provider' does not support file transcription",    "status": "transcription_not_supported",    "provider": "example-provider"  }}

{  "detail": {    "message": "upstream text-to-speech request failed",    "status": "upstream_error"  }}

ElevenLabs SDK-compatible STT (file upload)

Authorization

Query Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

402application/json

403application/json

422application/json

501application/json

502application/json

Example invalidMultipart

Example invalidTimestampsGranularity

Example invalidModel

Example missingApiKey

Example invalidApiKey

Example tenantDisabled

Example providerNotAllowed

Example missingFile

Example indeterminateAudioDuration

Example modelNotPriced

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`