Skip to main content
POST
curl

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 to transcribe, 25 MB maximum by default. Supported formats: flac, m4a, mp3, mp4, mpeg, mpga, oga, ogg, wav, webm.

model
string

Transcription model id, for example gpt-4o-transcribe. Defaults to the organization's default transcription model, then to the platform default.

Maximum string length: 256
language
string

ISO-639-1 language of the audio, for example fr. Improves accuracy on short recordings. Detected by the model when omitted.

prompt
string

Text that guides the transcription, such as expected vocabulary or the previous segment.

temperature
number

Sampling temperature, passed to the provider.

response_format
enum<string>
default:json

srt and vtt are not supported.

Available options:
json,
text,
verbose_json

Response

Transcribed text. application/json for json and verbose_json, text/plain for text.

text
string
required

Transcribed text.

usage
object

Provider usage, when the provider reports it.