HTTP API

Transcribe an uploaded audio file

POST /v1/audio/transcriptions

Base URL: https://api.simplellm.eu. Authenticate using Authorization: Bearer $SIMPLELLM_API_KEY.

Request body

Content-Type: multipart/form-data

Field	Type	Required	Meaning
`file`	`string`	Yes
`model`	`string`	No	Use whisper-large-v3 or whisper-large-v3-turbo. The compatibility alias whisper-1 maps to whisper-large-v3-turbo and is also the default; it is not a separate model. Default: `"whisper-1"`. Values: `whisper-1`, `whisper-large-v3`, `whisper-large-v3-turbo`.
`language`	`string`	No
`prompt`	`string`	No
`response_format`	`string`	No
`temperature`	`number`	No

Nested required fields are required only when their containing object is supplied. Extra chat parameters may be provider-specific; acceptance does not guarantee model support.

Example request

bash

curl --fail-with-body https://api.simplellm.eu/v1/audio/transcriptions \
  -H "Authorization: Bearer $SIMPLELLM_API_KEY" \
  -F 'file=@recording.wav' \
  -F 'model=whisper-large-v3-turbo' \
  -F 'language=en'

Responses

HTTP 200

Transcription in the requested upstream-supported format.

Content-Type: application/json

Field	Type	Required	Meaning
`text`	`string`	No

Illustrative response shape only; IDs, timestamps and counters below are synthetic, not live limits or customer data.

json

{
  "text": "example"
}

Content-Type: text/plain

Response type: string.

Content-Type: text/vtt

Response type: string.

Error handling

Errors can occur in authentication, billing, routing or the upstream service; not every status applies to every route.

Status	Meaning
400	Invalid request
401	Invalid credentials
402	Insufficient credits
403	Access denied
404	Model or resource not found
429	Rate or capacity limit
500	Internal error
502	Routing or upstream error
503	Temporarily unavailable
504	Deployment timeout

See Troubleshooting for response examples and Rate limits & retries for retry rules.

Machine-readable schema

Download OpenAPI JSON. Operation ID: createTranscription.