Gladia
Gladia — free-tier JSON endpoint
📚 Open DataUNMONITORED
AUTH APIKEYCORS ✓AGENT ?HTTPS ✓COMMERCIAL ?
Gladia offers a free API tier. We verified JSON on a sample GET (AI). Check provider docs for key requirements and limits.
ON PROBE SCHEDULE
We probe a documented GET and expect 2xx JSON — full uptime and health score. Open provider docs ↗
Uptime historystarts after first probe
On our probe schedule. Uptime charts appear after the first check lands.
Example responsefrom provider docs — not verified by us
GET https://api.gladia.io/openapi.json/
{
"openapi": "3.1.0",
"paths": {
"/v2/upload": {
"post": {
"operationId": "FileController_upload_v2",
"parameters": [],
"requestBody": {
"required": true,
"content": {
"multipart/form-data": {
"schema": {
"type": "object",
"properties": {
"audio": {
"type": "string",
"format": "binary",
"description": "The file to be uploaded. This should be an audio or video file."
}
}
}
},
"application/json": {
"schema": {
"type": "object",
"properties": {
"audio_url": {
"type": "string",
"description": "The URL of the audio or video file to be uploaded."
}
}
}
}
}
},
"responses": {
"200": {
"description": "",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/AudioUploadResponse"
}
}
}
}
},
"security": [
{
"x_gladia_key": []
}
],
"summary": "Upload an audio file or provide an audio URL for processing",
"tags": [
"File Management"
]
}
},
"/v2/pre-recorded": {
"post": {
"operationId": "PreRecordedController_initPreRecordedJob_v2",
"parameters": [],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InitTranscriptionRequest"
}
}
}
},
"responses": {
"201": {
"description": "The pre recorded job has been initiated",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InitPreRecordedTranscriptionResponse"
}
}
}
},
"400": {
"description": "Something is wrong with the request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BadRequestErrorResponse"
}
}
}
},
"401": {
"description": "You don't have the permissions to initiate a new pre recorded job",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UnauthorizedErrorResponse"
}
}
}
},
"422": {
"description": "The parameters you gave are incorrect",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UnprocessableEntityErrorResponse"
}
}
}
}
},
"security": [
{
"x_gladia_key": []
}
],
"summary": "Initiate a new pre recorded job",
"tags": [
"Pre-recorded V2"
]
},
"get": {
"operationId": "PreRecordedController_getPreRecordedJobs_v2",
"parameters": [
{
"name": "offset",
"required": false,
"in": "query",
"description": "The starting point for pagination. A value of 0 starts from the first item.",
"schema": {
"minimum": 0,
"default": 0,
"type": "integer"
}
},
{
"name": "limit",
"required": false,
"in": "query",
"description": "The maximum number of items to return. Useful for pagination and controlling data payload size.",
"schema": {
"minimum": 1,
"default": 20,
"type": "integer"
}
}
],
"responses": {
"200": {
"description": "A list of pre recorded jobs matching the parameters.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ListPreRecordedResponse"
}
}
}
},
"401": {
"description": "You don't have the permissions to access pre recorded jobs",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UnauthorizedErrorResponse"
}
}
}
}
},
"security": [
{
"x_gladia_key": []
}
],
"summary": "Get pre recorded jobs based on query parameters",
"tags": [
"Pre-recorded V2"
]
}
},
"/v2/pre-recorded/{id}": {
"get": {
"operationId": "PreRecordedController_getPreRecordedJob_v2",
"parameters": [
{
"name": "id",
"required": true,
"in": "path",
"description": "Id of the pre recorded job",
"schema": {
"example": "45463597-20b7-4af7-b3b3-f5fb778203ab",
"type": "string"
}
}
],
"responses": {
"200": {
"description": "The pre recorded job's metadata",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PreRecordedResponse"
}
}
}
},
"401": {
"description": "You don't have the permissions to access the pre recorded job",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UnauthorizedErrorResponse"
}
}
}
},
"404": {
"description": "The pre recorded job doesn't exist or has been deleted",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NotFoundErrorResponse"
}
}
}
}
},
"security": [
{
"x_gladia_key": []
}
],
"summary": "Get the pre recorded job's metadata",
"tags": [
"Pre-recorded V2"
]
},
"delete": {
"operationId": "PreRecordedController_deletePreRecordedJob_v2",
"parameters": [
{
"name": "id",
"required": true,
"in": "path",
"description": "Id of the pre recorded job",
"schema": {
"example": "45463597-20b7-4af7-b3b3-f5fb778203ab",
"type": "string"
}
}
],
"responses": {
"202": {
"description": "The pre recorded job has been successfully deleted"
},
"401": {
"description": "You don't have the permissions to delete this pre recorded job",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UnauthorizedErrorResponse"
}
}
}
},
"403": {
"description": "The pre recorded job is not in a deletable state",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ForbiddenErrorResponse"
}
}
}
},
"404": {
"description": "The pre recorded job doesn't exist or has been deleted",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NotFoundErrorResponse"
}
}
}
}
},
"security": [
{
"x_gladia_key": []
}
],
"summary": "Delete the pre recorded job",
"tags": [
"Pre-recorded V2"
]
}
},
"/v2/pre-recorded/{id}/file": {
"get": {
"operationId": "PreRecordedController_getAudio_v2",
"parameters": [
{
"name": "id",
"required": true,
"in": "path",
"description": "Id of the pre recorded job",
"schema": {
"example": "45463597-20b7-4af7-b3b3-f5fb778203ab",
"type": "string"
}
}
],
"responses": {
"200": {
"description": "The audio file used for this pre recorded job",
"content": {
"application/octet-stream": {
"schema": {
"type": "string",
"format": "binary",
"example": "<binary>"
}
}
}
},
"401": {
"description": "You don't have the permissions to access this pre recorded job or its audio file",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UnauthorizedErrorResponse"
}
}
}
},
"404": {
"description": "The pre recorded job or its audio file doesn't exist or has been deleted",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NotFoundErrorResponse"
}
}
}
}
},
"security": [
{
"x_gladia_key": []
}
],
"summary": "Download the audio file used for this pre recorded job",
"tags": [
"Pre-recorded V2"
]
}
},
"/v2/transcription": {
"post": {
"operationId": "TranscriptionController_initPreRecordedJob_v2",
"parameters": [],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InitTranscriptionRequest"
}
}
}
},
"responses": {
"201": {
"description": "The transcription job has been initiated",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/InitPreRecordedTranscriptionResponse"
}
}
}
},
"400": {
"description": "Something is wrong with the request",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BadRequestErrorResponse"
}
}
}
},
"401": {
"description": "You don't have the permissions to initiate a new transcription job",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UnauthorizedErrorResponse"
}
}
}
},
"422": {
"description": "The parameters you gave are incorrect",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UnprocessableEntityErrorResponse"
}
}
}
}
},
"security": [
{
"x_gladia_key": []
}
],
"summary": "Initiate a new transcription job",
"tags": [
"Transcription V2"
]
},
"get": {
"operationId": "TranscriptionController_list_v2",
"parameters": [
{
"name": "offset",
"required": false,
"in": "query",
"description": "The starting point for pagination. A value of 0 starts from the first item.",
"schema": {
"minimum": 0,
"default": 0,
"type": "integer"
}
},
{
"name": "limit",
"required": false,
"in": "query",
"description": "The maximum number of items to return. Useful for pagination and controlling data payload size.",
"schema": {
"minimum": 1,
"default": 20,
"type": "integer"
}
}
],
"responses": {
"200": {
"description": "A list of transcription jobs matching the parameters.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ListTranscriptionResponse"
}
}
}
},
"401": {
"description": "You don't have the permissions to access transcription jobs",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UnauthorizedErrorResponse"
}
}
}
}
},
"security": [
{
"x_gladia_key": []
}
],
"summary": "Get transcription jobs based on query parameters",
"tags": [
"Transcription V2"
]
}
},
"/v2/transcription/{id}": {
"get": {
"operationId": "TranscriptionController_getTranscript_v2",
"parameters": [
{
"name": "id",
"required": true,
"in": "path",
"description": "Id of the transcription job",
"schema": {
"example": "45463597-20b7-4af7-b3b3-f5fb778203ab",
"type": "string"
}
}
],
"responses": {
"200": {
"description": "The transcription job's metadata",
"content": {
"application/json": {
"schema": {
"example": {
"id": "45463597-20b7-4af7-b3b3-f5fb778203ab",
"request_id": "G-45463597",
"version": 2,
"kind": "pre-recorded",
"created_at": "2023-12-28T09:04:17.210Z",
"status": "queued",
"file": {
"id": "f0dcZE10-23d8-47f0-a25d-74a6eed88721",
"filename": "split_infinity.wav",
"source": "https://files.gladia.io/example/audio-transcription/split_infinity.wav",
"audio_duration": 20,
"number_of_channels": 1
},
"request_params": {
"audio_url": "https://files.gladia.io/example/audio-transcription/split_infinity.wav",
"subtitles": false,
"diarization": false,
"translation": false,
"summarization": false,
"sentences": false,
"moderation": false,
"named_entity_recognition": false
}
},
"oneOf": [
{
"$ref": "#/components/schemas/PreRecordedResponse"
},
{
"$ref": "#/components/schemas/StreamingResponse"
}
],
"discriminator": {
"propertyName": "kind",
"mapping": {
"pre-recorded": "#/components/schemas/PreRecordedResponse",
"live": "#/components/schemas/StreamingResponse"
}
}
}
}
}
},
"401": {
"description": "You don't have the permissions to access the transcription job",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UnauthorizedErrorResponse"
}
}
}
},
"404": {
"description": "The transcription job doesn't exist or has been deleted",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NotFoundErrorResponse"
}
}
}
}
},
"security": [
{
"x_gladia_key": []
}
],
"summary": "Get the transcription job's metadata",
"tags": [
"Transcription V2"
]
},
"delete": {
"operationId": "TranscriptionController_deleteTranscript_v2",
"parameters": [
{
"name": "id",
"required": true,
"in": "path",
"description": "Id of the transcription job",
"schema": {
"example": "45463597-20b7-4af7-b3b3-f5fb778203ab",
"type": "string"
}
}
],
"responses": {
"202": {
"description": "The transcription job has been successfully deleted"
},
"401": {
"description": "You don't have the permissions to delete this transcription job",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UnauthorizedErrorResponse"
}
}
}
},
"403": {
"description": "The transcription job is not in a deletable state",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ForbiddenErrorResponse"
}
}
}
},
"404": {
"description": "The transcription job doesn't exist or has been deleted",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NotFoundErrorResponse"
}
}
}
}
},
"security": [
{
"x_gladia_key": []
}
],
"summary": "Delete the transcription job",
"tags": [
"Transcription V2"
]
}
},
"/v2/transcription/{id}/file": {
"get": {
"operationId": "TranscriptionController_getAudio_v2",
"parameters": [
{
"name": "id",
"required": true,
"in": "path",
"description": "Id of the transcription job",
"schema": {
"example": "45463597-20b7-4af7-b3b3-f5fb778203ab",
"type": "string"
}
}
],
"responses": {
"200": {
"description": "The audio file used for this transcription job",
"content": {
"application/octet-stream": {
"schema": {
"type": "string",
"format": "binary",
"example": "<binary>"
}
}
}
},
"401": {
"description": "You don't have the permissions to access this transcription job or its audio file",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/UnauthorizedErrorResponse"
}
}
}
},
"404": {
"description": "The transcription job or its audio file doesn't exist or has been deleted",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NotFoundErrorResponse"
}
}
}
}
},
"security": [
{
"x_gladia_key": []
}
],
"summary": "Download the audio file used for this transcription job",
"tags": [
"Transcription V2"
]
}
},
"/audio/text/audio-transcription": {
"post": {
"operationId": "AudioToTextController_audioTranscription",
"parameters": [],
"requestBody": {
"required": true,
"content": {
"multipart/form-data": {
"schema": {
"type": "object",
"properties": {
"audio": {
"type": "string",
"format": "binary"
},
"audio_url": {
"type": "string",
"default": "https://files.gladia.io/example/audio-transcription/split_infinity.wav"
},
"language_behaviour": {
"type": "string",
"enum": [
"automatic single language",
"automatic multiple languages"
],
"default": "automatic single language"
},
"language": {
"type": "string",
"enum": [
"afrikaans",
"albanian"
]
},
"transcription_hint": {
"type": "string"
},
"toggle_diarization": {
"type": "boolean",
"default": false
},
"diarization_num_speakers": {
"type": "integer"
},
"diarization_min_speakers": {
"type": "integer"
}
}
}
}
}
},
"responses": {
"200": {
"description": ""
}
},
"security": [
{
"x_gladia_key": []
}
],
"tags": [
"AudioToText",
"Transcription V1"
]
}
}
},
"info": {
"title": "Gladia Control API",
"description": "",
"version": "1.0",
"contact": {}
},
"tags": [],
"servers": [
{
"url": "https://api.gladia.io/",
"description": "Gladia API production URL"
}
],
"components": {
"securitySchemes": {
"x_gladia_key": {
"type": "apiKey",
"in": "header",
"name": "x-gladia-key",
"description": "Your personal Gladia API key"
}
},
"schemas": {
"PreRecordedEventPayload": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Id of the job",
"format": "uuid",
"example": "45463597-20b7-4af7-b3b3-f5fb778203ab"
}
},
"required": [
"id"
]
},
"LiveEventPayload": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Id of the job",
"format": "uuid",
"example": "45463597-20b7-4af7-b3b3-f5fb778203ab"
}
},
"required": [
"id"
]
},
"UploadBody": {
"type": "object",
"properties": {}
},
"AudioUploadMetadataDTO": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Uploaded audio file ID",
"format": "uuid",
"example": "6c09400e-23d2-4bd2-be55-96a5ececfa3b"
},
"filename": {
"type": "string",
"description": "Uploaded audio filename",
"example": "short-audio-en-16000.wav"
},
"source": {
"type": "string",
"description": "Uploaded audio source",
"format": "uri",
"example": "https://files.gladia.io/example/audio-transcription/split_infinity.wav"
},
"extension": {
"type": "string",
"description": "Uploaded audio detected extension",
"format": "uuid",
"example": "wav"
},
"size": {
"type": "integer",
"description": "Uploaded audio size",
"example": 365702
},
"audio_duration": {
"type": "number",
"description": "Uploaded audio duration",
"example": 4.145782
},
"number_of_channels": {
"type": "integer",
"description": "Uploaded audio channel numbers",
"example": 1
}
},
"required": [
"id",
"filename"
]
},
"AudioUploadResponse": {
"type": "object",
"properties": {
"audio_url": {
"type": "string",
"description": "Uploaded audio file Gladia URL",
"format": "uri",
"example": "https://api.gladia.io/file/6c09400e-23d2-4bd2-be55-96a5ececfa3b"
},
"audio_metadata": {
"description": "Uploaded audio file detected metadata",
"allOf": [
{
"$ref": "#/components/schemas/AudioUploadMetadataDTO"
}
]
}
},
"required": [
"audio_url",
"audio_metadata"
]
},
"TranscriptionLanguageCodeEnum": {
"type": "string",
"enum": [
"af",
"am"
],
"description": "Specify the language in which it will be pronounced when sound comparison occurs. Default to transcription language."
},
"CustomVocabularyEntryDTO": {
"type": "object",
"properties": {
"value": {
"type": "string",
"description": "The text used to replace in the transcription.",
"example": "Gladia"
},
"intensity": {
"type": "number",
"description": "The global intensity of the feature.",
"example": 0.5,
"minimum": 0,
"maximum": 1
},
"pronunciations": {
"description": "The pronunciations used in the transcription.",
"type": "array",
"items": {
"type": "string"
}
},
"language": {
"description": "Specify the language in which it will be pronounced when sound comparison occurs. Default to transcription language.",
"example": "en",
"allOf": [
{
"$ref": "#/components/schemas/TranscriptionLanguageCodeEnum"
}
]
}
},
"required": [
"value"
]
},
"CustomVocabularyConfigDTO": {
"type": "object",
"properties": {
"vocabulary": {
"type": "array",
"description": "Specific vocabulary list to feed the transcription model with. Each item can be a string or an object with the following properties: value, intensity, pronunciations, language.",
"example": [
"Westeros",
{
"value": "Stark"
}
],
"items": {
"oneOf": [
{
"$ref": "#/components/schemas/CustomVocabularyEntryDTO"
},
{
"type": "string"
}
]
}
},
"default_intensity": {
"type": "number",
"description": "Default intensity for the custom vocabulary",
"example": 0.5,
"minimum": 0,
"maximum": 1
}
},
"required": [
"vocabulary"
]
}
}
},
"webhooks": {
"transcription.created": {
"post": {
"description": "Sent when a pre-recorded transcription job has been created",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WebhookTranscriptionCreatedPayload"
}
}
}
}
}
},
"transcription.success": {
"post": {
"description": "Sent when a pre-recorded transcription job is done and its results are available",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WebhookTranscriptionSuccessPayload"
}
}
}
}
}
},
"transcription.error": {
"post": {
"description": "Sent when an error occurred on a pre-recorded transcription job",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WebhookTranscriptionErrorPayload"
}
}
}
}
}
},
"live.start_session": {
"post": {
"description": "Sent when a live session has been initiated",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WebhookLiveStartSessionPayload"
}
}
}
}
}
},
"live.start_recording": {
"post": {
"description": "Sent when we received the first audio chunk of a live session",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WebhookLiveStartRecordingPayload"
}
}
}
}
}
},
"live.end_recording": {
"post": {
"description": "Sent when the live session recording has ended",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WebhookLiveEndRecordingPayload"
}
}
}
}
}
},
"live.end_session": {
"post": {
"description": "Sent when the live session post-processing has ended and the results are available",
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/WebhookLiveEndSessionPayload"
}
}
}
}
}
}
}
}Call itcurl · fetch · python
curl "https://api.gladia.io/openapi.json/"const res = await fetch("https://api.gladia.io/openapi.json/");
const data = await res.json();
console.log(data);import requests
res = requests.get("https://api.gladia.io/openapi.json/")
print(res.json())On schedule — GET /openapi.json/ awaits first probe
GET
/openapi.json/PROBEDGladia — free-tier JSON endpoint
GET
/openapi.json/?limit=5Paginated variant with limit parameter.
GET
/v2/pre-recordedGet pre recorded jobs based on query parameters
GET
/v2/pre-recorded/{id}Get the pre recorded job's metadata
GET
/v2/pre-recorded/{id}/fileDownload the audio file used for this pre recorded job
GET
/v2/transcriptionGet transcription jobs based on query parameters
Machine-readable spec
We probe a documented GET and expect 2xx JSON — full uptime and health score. Export includes every documented route below.
Response-shape history
Not tracked yet. Shape-change history starts once this API joins our probe schedule.
Gladia: common questions
Is Gladia free to use?
Yes — Gladia is a free open data API. Free tier: Free tier — API key may be required for production. Whether the free tier allows commercial use is unclear — check the provider docs.
Does Gladia need an API key?
Yes — Gladia needs a free API key, which you pass on each request. Rate limits: Unpublished.
Can I call Gladia from the browser?
Yes — Gladia returns CORS headers over HTTPS, so front-end code can fetch it directly with no backend proxy. Use the fetch snippet on this page, or hit "Run live" to try it now.
Is Gladia up right now?
Gladia is catalogued but not yet on our probe schedule, so we don't publish a live status for it. Check the provider's own status page or docs for its current state.