Skip to main content
POST
/
v1
/
audio
/
transcriptions
Create transcription
curl --request POST \
  --url https://api.dgrid.ai/v1/audio/transcriptions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file' \
  --form 'model=<string>' \
  --form 'language=<string>' \
  --form 'prompt=<string>' \
  --form response_format=json \
  --form temperature=0
{
  "text": "<string>"
}

Authorizations

​
Authorization
string
header
required

Your DGrid API key. All endpoints use Authorization: Bearer <DGRID_API_KEY>.

Body

multipart/form-data
​
file
file
required

Audio file up to 25 MB.

​
model
string
required

Model ID, such as whisper-1.

​
language
string

ISO-639-1 language code, such as en, zh, or ko.

​
prompt
string

Optional prompt for biasing the transcript.

​
response_format
enum<string>
default:json
Available options:
json,
text,
srt,
verbose_json,
vtt
​
temperature
number
default:0

Sampling temperature.

Required range: 0 <= x <= 1

Response

Transcript. When response_format is verbose_json, the response also includes task, language, duration, and per-segment timing metadata.

​
text
string

Transcript text.