Initiate a new pre recorded job
curl --request POST \
--url https://api.gladia.io/v2/pre-recorded \
--header 'Content-Type: application/json' \
--header 'x-gladia-key: <api-key>' \
--data '
{
"audio_url": "https://files.gladia.io/example/audio-transcription/split_infinity.wav",
"custom_vocabulary": false,
"callback_url": "https://callback.example",
"callback": false,
"subtitles": false,
"subtitles_config": {
"formats": [
"srt"
],
"minimum_duration": 1,
"maximum_duration": 15.5,
"maximum_characters_per_row": 2,
"maximum_rows_per_caption": 3,
"style": "default"
},
"diarization": false,
"diarization_config": {
"number_of_speakers": 3,
"min_speakers": 1,
"max_speakers": 2
},
"translation": false,
"summarization": false,
"summarization_config": {
"type": "general"
},
"named_entity_recognition": false,
"custom_spelling": false,
"sentiment_analysis": false,
"audio_to_llm": false,
"pii_redaction": false,
"pii_redaction_config": {
"entity_types": [
"GDPR",
"HEALTH_INFORMATION",
"HIPAA_SAFE_HARBOR",
"QUEBEC_PRIVACY_ACT",
"EMAIL_ADDRESS",
"NAME",
"PHONE_NUMBER"
],
"processed_text_type": "MARKER"
},
"custom_metadata": {
"user": "John Doe"
},
"sentences": false,
"punctuation_enhanced": false,
"language_config": {
"languages": [],
"code_switching": false
},
"model": "solaria-1"
}
'import requests
url = "https://api.gladia.io/v2/pre-recorded"
payload = {
"audio_url": "https://files.gladia.io/example/audio-transcription/split_infinity.wav",
"custom_vocabulary": False,
"callback_url": "https://callback.example",
"callback": False,
"subtitles": False,
"subtitles_config": {
"formats": ["srt"],
"minimum_duration": 1,
"maximum_duration": 15.5,
"maximum_characters_per_row": 2,
"maximum_rows_per_caption": 3,
"style": "default"
},
"diarization": False,
"diarization_config": {
"number_of_speakers": 3,
"min_speakers": 1,
"max_speakers": 2
},
"translation": False,
"summarization": False,
"summarization_config": { "type": "general" },
"named_entity_recognition": False,
"custom_spelling": False,
"sentiment_analysis": False,
"audio_to_llm": False,
"pii_redaction": False,
"pii_redaction_config": {
"entity_types": ["GDPR", "HEALTH_INFORMATION", "HIPAA_SAFE_HARBOR", "QUEBEC_PRIVACY_ACT", "EMAIL_ADDRESS", "NAME", "PHONE_NUMBER"],
"processed_text_type": "MARKER"
},
"custom_metadata": { "user": "John Doe" },
"sentences": False,
"punctuation_enhanced": False,
"language_config": {
"languages": [],
"code_switching": False
},
"model": "solaria-1"
}
headers = {
"x-gladia-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-gladia-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
audio_url: 'https://files.gladia.io/example/audio-transcription/split_infinity.wav',
custom_vocabulary: false,
callback_url: 'https://callback.example',
callback: false,
subtitles: false,
subtitles_config: {
formats: ['srt'],
minimum_duration: 1,
maximum_duration: 15.5,
maximum_characters_per_row: 2,
maximum_rows_per_caption: 3,
style: 'default'
},
diarization: false,
diarization_config: {number_of_speakers: 3, min_speakers: 1, max_speakers: 2},
translation: false,
summarization: false,
summarization_config: {type: 'general'},
named_entity_recognition: false,
custom_spelling: false,
sentiment_analysis: false,
audio_to_llm: false,
pii_redaction: false,
pii_redaction_config: {
entity_types: [
'GDPR',
'HEALTH_INFORMATION',
'HIPAA_SAFE_HARBOR',
'QUEBEC_PRIVACY_ACT',
'EMAIL_ADDRESS',
'NAME',
'PHONE_NUMBER'
],
processed_text_type: 'MARKER'
},
custom_metadata: {user: 'John Doe'},
sentences: false,
punctuation_enhanced: false,
language_config: {languages: [], code_switching: false},
model: 'solaria-1'
})
};
fetch('https://api.gladia.io/v2/pre-recorded', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gladia.io/v2/pre-recorded",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'audio_url' => 'https://files.gladia.io/example/audio-transcription/split_infinity.wav',
'custom_vocabulary' => false,
'callback_url' => 'https://callback.example',
'callback' => false,
'subtitles' => false,
'subtitles_config' => [
'formats' => [
'srt'
],
'minimum_duration' => 1,
'maximum_duration' => 15.5,
'maximum_characters_per_row' => 2,
'maximum_rows_per_caption' => 3,
'style' => 'default'
],
'diarization' => false,
'diarization_config' => [
'number_of_speakers' => 3,
'min_speakers' => 1,
'max_speakers' => 2
],
'translation' => false,
'summarization' => false,
'summarization_config' => [
'type' => 'general'
],
'named_entity_recognition' => false,
'custom_spelling' => false,
'sentiment_analysis' => false,
'audio_to_llm' => false,
'pii_redaction' => false,
'pii_redaction_config' => [
'entity_types' => [
'GDPR',
'HEALTH_INFORMATION',
'HIPAA_SAFE_HARBOR',
'QUEBEC_PRIVACY_ACT',
'EMAIL_ADDRESS',
'NAME',
'PHONE_NUMBER'
],
'processed_text_type' => 'MARKER'
],
'custom_metadata' => [
'user' => 'John Doe'
],
'sentences' => false,
'punctuation_enhanced' => false,
'language_config' => [
'languages' => [
],
'code_switching' => false
],
'model' => 'solaria-1'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-gladia-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.gladia.io/v2/pre-recorded"
payload := strings.NewReader("{\n \"audio_url\": \"https://files.gladia.io/example/audio-transcription/split_infinity.wav\",\n \"custom_vocabulary\": false,\n \"callback_url\": \"https://callback.example\",\n \"callback\": false,\n \"subtitles\": false,\n \"subtitles_config\": {\n \"formats\": [\n \"srt\"\n ],\n \"minimum_duration\": 1,\n \"maximum_duration\": 15.5,\n \"maximum_characters_per_row\": 2,\n \"maximum_rows_per_caption\": 3,\n \"style\": \"default\"\n },\n \"diarization\": false,\n \"diarization_config\": {\n \"number_of_speakers\": 3,\n \"min_speakers\": 1,\n \"max_speakers\": 2\n },\n \"translation\": false,\n \"summarization\": false,\n \"summarization_config\": {\n \"type\": \"general\"\n },\n \"named_entity_recognition\": false,\n \"custom_spelling\": false,\n \"sentiment_analysis\": false,\n \"audio_to_llm\": false,\n \"pii_redaction\": false,\n \"pii_redaction_config\": {\n \"entity_types\": [\n \"GDPR\",\n \"HEALTH_INFORMATION\",\n \"HIPAA_SAFE_HARBOR\",\n \"QUEBEC_PRIVACY_ACT\",\n \"EMAIL_ADDRESS\",\n \"NAME\",\n \"PHONE_NUMBER\"\n ],\n \"processed_text_type\": \"MARKER\"\n },\n \"custom_metadata\": {\n \"user\": \"John Doe\"\n },\n \"sentences\": false,\n \"punctuation_enhanced\": false,\n \"language_config\": {\n \"languages\": [],\n \"code_switching\": false\n },\n \"model\": \"solaria-1\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-gladia-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.gladia.io/v2/pre-recorded")
.header("x-gladia-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"audio_url\": \"https://files.gladia.io/example/audio-transcription/split_infinity.wav\",\n \"custom_vocabulary\": false,\n \"callback_url\": \"https://callback.example\",\n \"callback\": false,\n \"subtitles\": false,\n \"subtitles_config\": {\n \"formats\": [\n \"srt\"\n ],\n \"minimum_duration\": 1,\n \"maximum_duration\": 15.5,\n \"maximum_characters_per_row\": 2,\n \"maximum_rows_per_caption\": 3,\n \"style\": \"default\"\n },\n \"diarization\": false,\n \"diarization_config\": {\n \"number_of_speakers\": 3,\n \"min_speakers\": 1,\n \"max_speakers\": 2\n },\n \"translation\": false,\n \"summarization\": false,\n \"summarization_config\": {\n \"type\": \"general\"\n },\n \"named_entity_recognition\": false,\n \"custom_spelling\": false,\n \"sentiment_analysis\": false,\n \"audio_to_llm\": false,\n \"pii_redaction\": false,\n \"pii_redaction_config\": {\n \"entity_types\": [\n \"GDPR\",\n \"HEALTH_INFORMATION\",\n \"HIPAA_SAFE_HARBOR\",\n \"QUEBEC_PRIVACY_ACT\",\n \"EMAIL_ADDRESS\",\n \"NAME\",\n \"PHONE_NUMBER\"\n ],\n \"processed_text_type\": \"MARKER\"\n },\n \"custom_metadata\": {\n \"user\": \"John Doe\"\n },\n \"sentences\": false,\n \"punctuation_enhanced\": false,\n \"language_config\": {\n \"languages\": [],\n \"code_switching\": false\n },\n \"model\": \"solaria-1\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gladia.io/v2/pre-recorded")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-gladia-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"audio_url\": \"https://files.gladia.io/example/audio-transcription/split_infinity.wav\",\n \"custom_vocabulary\": false,\n \"callback_url\": \"https://callback.example\",\n \"callback\": false,\n \"subtitles\": false,\n \"subtitles_config\": {\n \"formats\": [\n \"srt\"\n ],\n \"minimum_duration\": 1,\n \"maximum_duration\": 15.5,\n \"maximum_characters_per_row\": 2,\n \"maximum_rows_per_caption\": 3,\n \"style\": \"default\"\n },\n \"diarization\": false,\n \"diarization_config\": {\n \"number_of_speakers\": 3,\n \"min_speakers\": 1,\n \"max_speakers\": 2\n },\n \"translation\": false,\n \"summarization\": false,\n \"summarization_config\": {\n \"type\": \"general\"\n },\n \"named_entity_recognition\": false,\n \"custom_spelling\": false,\n \"sentiment_analysis\": false,\n \"audio_to_llm\": false,\n \"pii_redaction\": false,\n \"pii_redaction_config\": {\n \"entity_types\": [\n \"GDPR\",\n \"HEALTH_INFORMATION\",\n \"HIPAA_SAFE_HARBOR\",\n \"QUEBEC_PRIVACY_ACT\",\n \"EMAIL_ADDRESS\",\n \"NAME\",\n \"PHONE_NUMBER\"\n ],\n \"processed_text_type\": \"MARKER\"\n },\n \"custom_metadata\": {\n \"user\": \"John Doe\"\n },\n \"sentences\": false,\n \"punctuation_enhanced\": false,\n \"language_config\": {\n \"languages\": [],\n \"code_switching\": false\n },\n \"model\": \"solaria-1\"\n}"
response = http.request(request)
puts response.read_body{
"id": "45463597-20b7-4af7-b3b3-f5fb778203ab",
"result_url": "https://api.gladia.io/v2/transcription/45463597-20b7-4af7-b3b3-f5fb778203ab"
}{
"timestamp": "2023-12-28T09:04:17.210Z",
"path": "/v2/transcription/45463597-20b7-4af7-b3b3-f5fb778203ab",
"request_id": "G-821fe9df",
"statusCode": 400,
"message": "Content-Type is missing Multipart Boundary.",
"validation_errors": [
"Field \"language\" must be a string",
"Field \"min_speakers\" must be a number"
]
}{
"timestamp": "2023-12-28T09:04:17.210Z",
"path": "/v2/transcription/45463597-20b7-4af7-b3b3-f5fb778203ab",
"request_id": "G-821fe9df",
"statusCode": 401,
"message": "gladia key not found"
}{
"timestamp": "2023-12-28T09:04:17.210Z",
"path": "/v2/transcription/45463597-20b7-4af7-b3b3-f5fb778203ab",
"request_id": "G-821fe9df",
"statusCode": 422,
"message": "Invalid parameter"
}Initiate a transcription
Initiate a pre-recorded transcription job. Use the returned id and the GET /v2/pre-recorded/:id endpoint to obtain the results.
POST
/
v2
/
pre-recorded
Initiate a new pre recorded job
curl --request POST \
--url https://api.gladia.io/v2/pre-recorded \
--header 'Content-Type: application/json' \
--header 'x-gladia-key: <api-key>' \
--data '
{
"audio_url": "https://files.gladia.io/example/audio-transcription/split_infinity.wav",
"custom_vocabulary": false,
"callback_url": "https://callback.example",
"callback": false,
"subtitles": false,
"subtitles_config": {
"formats": [
"srt"
],
"minimum_duration": 1,
"maximum_duration": 15.5,
"maximum_characters_per_row": 2,
"maximum_rows_per_caption": 3,
"style": "default"
},
"diarization": false,
"diarization_config": {
"number_of_speakers": 3,
"min_speakers": 1,
"max_speakers": 2
},
"translation": false,
"summarization": false,
"summarization_config": {
"type": "general"
},
"named_entity_recognition": false,
"custom_spelling": false,
"sentiment_analysis": false,
"audio_to_llm": false,
"pii_redaction": false,
"pii_redaction_config": {
"entity_types": [
"GDPR",
"HEALTH_INFORMATION",
"HIPAA_SAFE_HARBOR",
"QUEBEC_PRIVACY_ACT",
"EMAIL_ADDRESS",
"NAME",
"PHONE_NUMBER"
],
"processed_text_type": "MARKER"
},
"custom_metadata": {
"user": "John Doe"
},
"sentences": false,
"punctuation_enhanced": false,
"language_config": {
"languages": [],
"code_switching": false
},
"model": "solaria-1"
}
'import requests
url = "https://api.gladia.io/v2/pre-recorded"
payload = {
"audio_url": "https://files.gladia.io/example/audio-transcription/split_infinity.wav",
"custom_vocabulary": False,
"callback_url": "https://callback.example",
"callback": False,
"subtitles": False,
"subtitles_config": {
"formats": ["srt"],
"minimum_duration": 1,
"maximum_duration": 15.5,
"maximum_characters_per_row": 2,
"maximum_rows_per_caption": 3,
"style": "default"
},
"diarization": False,
"diarization_config": {
"number_of_speakers": 3,
"min_speakers": 1,
"max_speakers": 2
},
"translation": False,
"summarization": False,
"summarization_config": { "type": "general" },
"named_entity_recognition": False,
"custom_spelling": False,
"sentiment_analysis": False,
"audio_to_llm": False,
"pii_redaction": False,
"pii_redaction_config": {
"entity_types": ["GDPR", "HEALTH_INFORMATION", "HIPAA_SAFE_HARBOR", "QUEBEC_PRIVACY_ACT", "EMAIL_ADDRESS", "NAME", "PHONE_NUMBER"],
"processed_text_type": "MARKER"
},
"custom_metadata": { "user": "John Doe" },
"sentences": False,
"punctuation_enhanced": False,
"language_config": {
"languages": [],
"code_switching": False
},
"model": "solaria-1"
}
headers = {
"x-gladia-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-gladia-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
audio_url: 'https://files.gladia.io/example/audio-transcription/split_infinity.wav',
custom_vocabulary: false,
callback_url: 'https://callback.example',
callback: false,
subtitles: false,
subtitles_config: {
formats: ['srt'],
minimum_duration: 1,
maximum_duration: 15.5,
maximum_characters_per_row: 2,
maximum_rows_per_caption: 3,
style: 'default'
},
diarization: false,
diarization_config: {number_of_speakers: 3, min_speakers: 1, max_speakers: 2},
translation: false,
summarization: false,
summarization_config: {type: 'general'},
named_entity_recognition: false,
custom_spelling: false,
sentiment_analysis: false,
audio_to_llm: false,
pii_redaction: false,
pii_redaction_config: {
entity_types: [
'GDPR',
'HEALTH_INFORMATION',
'HIPAA_SAFE_HARBOR',
'QUEBEC_PRIVACY_ACT',
'EMAIL_ADDRESS',
'NAME',
'PHONE_NUMBER'
],
processed_text_type: 'MARKER'
},
custom_metadata: {user: 'John Doe'},
sentences: false,
punctuation_enhanced: false,
language_config: {languages: [], code_switching: false},
model: 'solaria-1'
})
};
fetch('https://api.gladia.io/v2/pre-recorded', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.gladia.io/v2/pre-recorded",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'audio_url' => 'https://files.gladia.io/example/audio-transcription/split_infinity.wav',
'custom_vocabulary' => false,
'callback_url' => 'https://callback.example',
'callback' => false,
'subtitles' => false,
'subtitles_config' => [
'formats' => [
'srt'
],
'minimum_duration' => 1,
'maximum_duration' => 15.5,
'maximum_characters_per_row' => 2,
'maximum_rows_per_caption' => 3,
'style' => 'default'
],
'diarization' => false,
'diarization_config' => [
'number_of_speakers' => 3,
'min_speakers' => 1,
'max_speakers' => 2
],
'translation' => false,
'summarization' => false,
'summarization_config' => [
'type' => 'general'
],
'named_entity_recognition' => false,
'custom_spelling' => false,
'sentiment_analysis' => false,
'audio_to_llm' => false,
'pii_redaction' => false,
'pii_redaction_config' => [
'entity_types' => [
'GDPR',
'HEALTH_INFORMATION',
'HIPAA_SAFE_HARBOR',
'QUEBEC_PRIVACY_ACT',
'EMAIL_ADDRESS',
'NAME',
'PHONE_NUMBER'
],
'processed_text_type' => 'MARKER'
],
'custom_metadata' => [
'user' => 'John Doe'
],
'sentences' => false,
'punctuation_enhanced' => false,
'language_config' => [
'languages' => [
],
'code_switching' => false
],
'model' => 'solaria-1'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-gladia-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.gladia.io/v2/pre-recorded"
payload := strings.NewReader("{\n \"audio_url\": \"https://files.gladia.io/example/audio-transcription/split_infinity.wav\",\n \"custom_vocabulary\": false,\n \"callback_url\": \"https://callback.example\",\n \"callback\": false,\n \"subtitles\": false,\n \"subtitles_config\": {\n \"formats\": [\n \"srt\"\n ],\n \"minimum_duration\": 1,\n \"maximum_duration\": 15.5,\n \"maximum_characters_per_row\": 2,\n \"maximum_rows_per_caption\": 3,\n \"style\": \"default\"\n },\n \"diarization\": false,\n \"diarization_config\": {\n \"number_of_speakers\": 3,\n \"min_speakers\": 1,\n \"max_speakers\": 2\n },\n \"translation\": false,\n \"summarization\": false,\n \"summarization_config\": {\n \"type\": \"general\"\n },\n \"named_entity_recognition\": false,\n \"custom_spelling\": false,\n \"sentiment_analysis\": false,\n \"audio_to_llm\": false,\n \"pii_redaction\": false,\n \"pii_redaction_config\": {\n \"entity_types\": [\n \"GDPR\",\n \"HEALTH_INFORMATION\",\n \"HIPAA_SAFE_HARBOR\",\n \"QUEBEC_PRIVACY_ACT\",\n \"EMAIL_ADDRESS\",\n \"NAME\",\n \"PHONE_NUMBER\"\n ],\n \"processed_text_type\": \"MARKER\"\n },\n \"custom_metadata\": {\n \"user\": \"John Doe\"\n },\n \"sentences\": false,\n \"punctuation_enhanced\": false,\n \"language_config\": {\n \"languages\": [],\n \"code_switching\": false\n },\n \"model\": \"solaria-1\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-gladia-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.gladia.io/v2/pre-recorded")
.header("x-gladia-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"audio_url\": \"https://files.gladia.io/example/audio-transcription/split_infinity.wav\",\n \"custom_vocabulary\": false,\n \"callback_url\": \"https://callback.example\",\n \"callback\": false,\n \"subtitles\": false,\n \"subtitles_config\": {\n \"formats\": [\n \"srt\"\n ],\n \"minimum_duration\": 1,\n \"maximum_duration\": 15.5,\n \"maximum_characters_per_row\": 2,\n \"maximum_rows_per_caption\": 3,\n \"style\": \"default\"\n },\n \"diarization\": false,\n \"diarization_config\": {\n \"number_of_speakers\": 3,\n \"min_speakers\": 1,\n \"max_speakers\": 2\n },\n \"translation\": false,\n \"summarization\": false,\n \"summarization_config\": {\n \"type\": \"general\"\n },\n \"named_entity_recognition\": false,\n \"custom_spelling\": false,\n \"sentiment_analysis\": false,\n \"audio_to_llm\": false,\n \"pii_redaction\": false,\n \"pii_redaction_config\": {\n \"entity_types\": [\n \"GDPR\",\n \"HEALTH_INFORMATION\",\n \"HIPAA_SAFE_HARBOR\",\n \"QUEBEC_PRIVACY_ACT\",\n \"EMAIL_ADDRESS\",\n \"NAME\",\n \"PHONE_NUMBER\"\n ],\n \"processed_text_type\": \"MARKER\"\n },\n \"custom_metadata\": {\n \"user\": \"John Doe\"\n },\n \"sentences\": false,\n \"punctuation_enhanced\": false,\n \"language_config\": {\n \"languages\": [],\n \"code_switching\": false\n },\n \"model\": \"solaria-1\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.gladia.io/v2/pre-recorded")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-gladia-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"audio_url\": \"https://files.gladia.io/example/audio-transcription/split_infinity.wav\",\n \"custom_vocabulary\": false,\n \"callback_url\": \"https://callback.example\",\n \"callback\": false,\n \"subtitles\": false,\n \"subtitles_config\": {\n \"formats\": [\n \"srt\"\n ],\n \"minimum_duration\": 1,\n \"maximum_duration\": 15.5,\n \"maximum_characters_per_row\": 2,\n \"maximum_rows_per_caption\": 3,\n \"style\": \"default\"\n },\n \"diarization\": false,\n \"diarization_config\": {\n \"number_of_speakers\": 3,\n \"min_speakers\": 1,\n \"max_speakers\": 2\n },\n \"translation\": false,\n \"summarization\": false,\n \"summarization_config\": {\n \"type\": \"general\"\n },\n \"named_entity_recognition\": false,\n \"custom_spelling\": false,\n \"sentiment_analysis\": false,\n \"audio_to_llm\": false,\n \"pii_redaction\": false,\n \"pii_redaction_config\": {\n \"entity_types\": [\n \"GDPR\",\n \"HEALTH_INFORMATION\",\n \"HIPAA_SAFE_HARBOR\",\n \"QUEBEC_PRIVACY_ACT\",\n \"EMAIL_ADDRESS\",\n \"NAME\",\n \"PHONE_NUMBER\"\n ],\n \"processed_text_type\": \"MARKER\"\n },\n \"custom_metadata\": {\n \"user\": \"John Doe\"\n },\n \"sentences\": false,\n \"punctuation_enhanced\": false,\n \"language_config\": {\n \"languages\": [],\n \"code_switching\": false\n },\n \"model\": \"solaria-1\"\n}"
response = http.request(request)
puts response.read_body{
"id": "45463597-20b7-4af7-b3b3-f5fb778203ab",
"result_url": "https://api.gladia.io/v2/transcription/45463597-20b7-4af7-b3b3-f5fb778203ab"
}{
"timestamp": "2023-12-28T09:04:17.210Z",
"path": "/v2/transcription/45463597-20b7-4af7-b3b3-f5fb778203ab",
"request_id": "G-821fe9df",
"statusCode": 400,
"message": "Content-Type is missing Multipart Boundary.",
"validation_errors": [
"Field \"language\" must be a string",
"Field \"min_speakers\" must be a number"
]
}{
"timestamp": "2023-12-28T09:04:17.210Z",
"path": "/v2/transcription/45463597-20b7-4af7-b3b3-f5fb778203ab",
"request_id": "G-821fe9df",
"statusCode": 401,
"message": "gladia key not found"
}{
"timestamp": "2023-12-28T09:04:17.210Z",
"path": "/v2/transcription/45463597-20b7-4af7-b3b3-f5fb778203ab",
"request_id": "G-821fe9df",
"statusCode": 422,
"message": "Invalid parameter"
}Pass
model to choose the transcription model:"solaria-3" — our latest model: highest accuracy on European real-world audio.- Async (pre-recorded) only — not available for live transcription.
- Languages: English, French, German, Spanish, Italian
- Single language only — pass exactly one language in
language_config.languages(no code switching). - All Audio Intelligence add-ons available.
"solaria-1" — our generalist model: maximum language coverage across any domain.- Available for async and live.
- Code switching and multi-language configuration (100+ languages covered)
- All Audio Intelligence add-ons available.
Authorizations
Your personal Gladia API key
Body
application/json
URL to a Gladia file or to an external audio or video file
Example:
"https://files.gladia.io/example/audio-transcription/split_infinity.wav"
[Beta] Can be either boolean to enable custom_vocabulary for this audio or an array with specific vocabulary list to feed the transcription model with
[Beta] Custom vocabulary configuration, if custom_vocabulary is enabled
Show child attributes
Show child attributes
[Deprecated] Use callback/callback_config instead. Callback URL we will do a POST request to with the result of the transcription
Example:
"https://callback.example"
Enable callback for this transcription. If true, the callback_config property will be used to customize the callback behaviour
Customize the callback behaviour (url and http method)
Show child attributes
Show child attributes
Enable subtitles generation for this transcription
Configuration for subtitles generation if subtitles is enabled
Show child attributes
Show child attributes
Enable speaker recognition (diarization) for this audio
Speaker recognition configuration, if diarization is enabled
Show child attributes
Show child attributes
[Beta] Enable translation for this audio
[Beta] Translation configuration, if translation is enabled
Show child attributes
Show child attributes
Enable summarization for this audio
Summarization configuration, if summarization is enabled
Show child attributes
Show child attributes
[Alpha] Enable named entity recognition for this audio
[Alpha] Enable custom spelling for this audio
[Alpha] Custom spelling configuration, if custom_spelling is enabled
Show child attributes
Show child attributes
Enable sentiment analysis for this audio
Enable audio to LLM processing for this audio
Audio to LLM configuration, if audio_to_llm is enabled
Show child attributes
Show child attributes
Enable PII redaction for this audio
PII redaction configuration, if pii_redaction is enabled
Show child attributes
Show child attributes
Custom metadata you can attach to this transcription
Example:
{ "user": "John Doe" }
Enable sentences for this audio
[Alpha] Use enhanced punctuation for this audio
Specify the language configuration
Show child attributes
Show child attributes
The model used to process the audio. "solaria-1" is used by default.
Available options:
solaria-1, solaria-3, solaria-fusion Response
The pre recorded job has been initiated
⌘I