Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

The workspace API key (pdk_…) from Integrations → Built-in in the pre.dev dashboard.

Headers

x-predev-project-id
string

Attribute this call to one of the workspace's projects. An id the workspace does not own is ignored.

Body

multipart/form-data
file
file
required

The audio file. The format comes from the filename extension or the part's content type.

model
string
required

A transcription model id, such as openai/whisper-large-v3. Transcription models are not listed by the catalog endpoints.

Example:

"openai/whisper-large-v3"

language
string

ISO-639-1 code. Detected when omitted.

Example:

"en"

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

Response

The transcript.

text
string
required
language
string

With verbose_json.

duration
number

Seconds, with verbose_json.

segments
object[]

Timed segments, with verbose_json.

usage
object