Skip to main content
POST
Transcribe audio into text

Authorizations

Authorization
string
header
required

User-bound credential carrying an identity: either a session JWT or a user access token (at:*) generated from the user settings UI. Send as Authorization: Bearer <token>. Org API keys (iak_*) are not accepted here - they carry no user identity. Use the x-prismeai-api-key header instead (see OrgApiKeyAuth).

Body

multipart/form-data
file
file
required

Audio file (webm, mp4, m4a, mp3, ogg, wav, flac), 25 MB max by default.

model
string
Maximum string length: 256
language
string

ISO-639-1 language of the audio (e.g. fr). Detected when omitted.

prompt
string

Text to guide the transcription (vocabulary, previous segment).

temperature
number
response_format
enum<string>
default:json
Available options:
json,
text,
verbose_json

Response

Transcribed text.

text
string
required
usage
object

Provider usage, when reported.