> ## Documentation Index
> Fetch the complete documentation index at: https://docs.slng.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Whisper Large v3
> Receive transcripts from Whisper Large v3
export const HostingBanner = ({type = "slng", provider, regions = []}) => {
const isSlng = type === "slng";
const regionLabel = regions.map(r => r.toUpperCase()).join(", ");
return
{isSlng ? "SLNG Sovereign Hosting" : `3rd Party API Hosted by ${provider}`}
{isSlng ? <>
On demand in: {regionLabel}.{" "}
Request here if you want access
in any other of our 11 regions.
: <>
For SLNG Sovereign Hosting in any of our 11 regions{" "}
contact us.
}
;
};
## OpenAPI
````yaml POST /v1/stt/slng/openai/whisper:large-v3
openapi: 3.0.3
info:
title: SLNG Gateway API - SLNG STT
version: 0.1.0
description: Unified API for speech-to-text and text-to-speech services.
contact:
name: SLNG Support
email: support@slng.ai
servers:
- url: https://api.slng.ai
description: Production
- url: https://stageapi.slng.ai
description: Staging
security:
- BearerAuth: []
tags:
- name: Whisper Large v3 (Compressed)
description: Compressed Whisper Large v3 for faster processing.
- name: Deepgram Nova 3
description: Deepgram Nova 3 with VAD and speaker diarization.
- name: Whisper Large v3
description: Whisper Large v3 with 99+ language support.
paths:
/v1/stt/slng/openai/whisper:large-v3:
post:
tags:
- Whisper Large v3
summary: Whisper Large v3
description: Receive transcripts from Whisper Large v3
operationId: sttWhisperLargeV3Receive
parameters:
- $ref: '#/components/parameters/XWorldPartSlngWhisper'
requestBody:
required: true
content:
multipart/form-data:
schema:
$ref: '#/components/schemas/WhisperTranscriptionRequest'
examples:
binary:
summary: Binary audio upload
value:
audio:
language: en
application/json:
schema:
$ref: '#/components/schemas/WhisperTranscriptionRequest'
examples:
url:
summary: URL-based transcription
value:
url: https://docs.slng.ai/audio/hello.wav
language: en
responses:
'200':
$ref: '#/components/responses/WhisperTranscriptionSuccess'
'400':
$ref: '#/components/responses/WhisperBadRequest'
'401':
$ref: '#/components/responses/ProviderUnauthorized'
'413':
$ref: '#/components/responses/WhisperPayloadTooLarge'
'500':
$ref: '#/components/responses/WhisperInternalServerError'
'503':
$ref: '#/components/responses/ProviderServiceUnavailable'
components:
parameters:
XWorldPartSlngWhisper:
name: X-World-Part-Override
in: header
required: false
description: Target world part override. Auto-selected if not provided.
schema:
type: string
enum:
- eu
schemas:
WhisperTranscriptionRequest:
type: object
description: >-
Whisper transcription request. Provide either `audio` (multipart upload)
or `url` (publicly accessible HTTPS URL).
properties:
audio:
type: string
format: binary
description: >-
Audio file (multipart) or base64-encoded audio (JSON). Formats: mp3,
mp4, mpeg, mpga, m4a, wav, webm. Max 25MB.
url:
type: string
description: Publicly accessible audio URL.
example: https://docs.slng.ai/audio/hello.wav
language:
$ref: '#/components/schemas/WhisperLanguageCode'
WhisperLanguageCode:
type: string
description: ISO-639-1 language code. Auto-detected if not specified.
example: en
enum:
- af
- am
- ar
- as
- az
- ba
- be
- bg
- bn
- bo
- br
- bs
- ca
- cs
- cy
- da
- de
- el
- en
- es
- et
- eu
- fa
- fi
- fo
- fr
- gl
- gu
- ha
- haw
- he
- hi
- hr
- ht
- hu
- hy
- id
- is
- it
- ja
- jw
- ka
- kk
- km
- kn
- ko
- la
- lb
- ln
- lo
- lt
- lv
- mg
- mi
- mk
- ml
- mn
- mr
- ms
- mt
- my
- ne
- nl
- nn
- 'no'
- oc
- pa
- pl
- ps
- pt
- ro
- ru
- sa
- sd
- si
- sk
- sl
- sn
- so
- sq
- sr
- su
- sv
- sw
- ta
- te
- tg
- th
- tk
- tl
- tr
- tt
- uk
- ur
- uz
- vi
- yi
- yo
- zh
- yue
WhisperTranscriptionResponse:
type: object
description: Whisper STT response format.
required:
- text
properties:
text:
type: string
description: Transcribed text.
language:
type: string
description: Detected language code (may not be present in all variants).
WhisperErrorResponse:
type: object
description: Whisper-specific error response.
properties:
error:
type: string
description: Error message.
required:
- error
ProviderErrorResponse:
type: object
description: >
Provider error response. Contains error information from the upstream
provider.
Common errors include invalid speakers, unsupported languages, or
malformed requests.
properties:
error:
type: string
description: >-
Error type or category (e.g., "TTS service error", "Validation
error").
example: TTS service error
status:
type: number
description: >-
Original HTTP status code from the provider (may differ from gateway
response code).
example: 400
details:
type: string
description: >
Detailed error message from the provider. For TTS errors, this
typically includes
the specific validation failure (e.g., invalid speaker ID for the
selected model/language).
example: >-
Rime TTS API error: 400 Bad Request - Invalid argument: Invalid
speaker: aurelie
required:
- error
responses:
WhisperTranscriptionSuccess:
description: Transcription successful.
content:
application/json:
schema:
$ref: '#/components/schemas/WhisperTranscriptionResponse'
examples:
english:
summary: English transcription
value:
text: Hello, welcome to SLNG's speech-to-text API.
language: en
spanish:
summary: Spanish transcription
value:
text: Hola, bienvenido a la API de texto a voz de SLNG.
language: es
WhisperBadRequest:
description: Invalid or missing audio file.
content:
application/json:
schema:
$ref: '#/components/schemas/WhisperErrorResponse'
examples:
missing-audio:
summary: Missing audio
value:
error: 'Missing required field: audio'
ProviderUnauthorized:
description: Invalid or missing API key.
content:
application/json:
schema:
$ref: '#/components/schemas/ProviderErrorResponse'
WhisperPayloadTooLarge:
description: Audio file exceeds 25MB limit.
content:
application/json:
schema:
$ref: '#/components/schemas/WhisperErrorResponse'
examples:
too-large:
summary: File too large
value:
error: Audio file size exceeds maximum limit of 25MB
WhisperInternalServerError:
description: Internal server error.
content:
application/json:
schema:
$ref: '#/components/schemas/WhisperErrorResponse'
examples:
processing-error:
summary: Processing error
value:
error: Failed to process audio file
ProviderServiceUnavailable:
description: Service unavailable.
content:
application/json:
schema:
$ref: '#/components/schemas/ProviderErrorResponse'
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: |
API key issued by SLNG. Pass as `Authorization: Bearer `.
````