Transgate API
A powerful RESTful API for transcription jobs. Submit audio files and retrieve high-quality transcription results with speaker identification.
Authentication
All API requests require an API key to be included in the request header:
Authorization: Bearer YOUR_API_KEYSubmit Transcription Job (URL)
Submit an audio file for transcription by providing its URL.
Endpoint
POST /api/v1/transcriptions/urlRequest Body
1{
2 "audio_url": "https://example.com/audio.mp3",
3 "language": "Azerbaijani", // Optional
4 "callback_url": "https://your-callback-url.com/webhook" // Optional
5}Example
1curl -X POST https://transgate.ai/api/v1/transcriptions/url \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "audio_url": "https://example.com/audio.mp3",
6 "language": "Azerbaijani",
7 "callback_url": "https://your-callback-url.com/webhook"
8}'Response (202 Accepted)
1{
2 "job_id": "123"
3}Possible Error Responses
Bad Request: Invalid request body
Unauthorized: Invalid or missing API key
Payment Required: Insufficient balance
Internal Server Error: Server-side error
Get Transcription Status and Results
Retrieve the status and results of a transcription job.
Endpoint
GET /api/v1/transcriptions/[job_id]Example
1curl -X GET https://transgate.ai/api/v1/transcriptions/123 \
2 -H "Authorization: Bearer YOUR_API_KEY"Response (200 OK)
1{
2 "job": {
3 "id": 123,
4 "status": "completed",
5 "duration": "00:05:30",
6 "language": "en",
7 "audio_url": "https://example.com/audio.mp3"
8 },
9 "result": [
10 {
11 "start_time": "00:00:00",
12 "end_time": "00:00:05",
13 "text": "Hello, this is the first segment of the transcription.",
14 "corrected_text": "Hello, this is the first segment of the transcription.",
15 "speaker": "SPEAKER_00"
16 }
17 ],
18 "errors": [
19 {
20 "message": "Error message",
21 "stage": "download|validation|duration|processing|transcription|diarization|alignment|speaker_assignment|grammar_fixing|callback|logs",
22 "category": "fatal|partial|transient",
23 }
24 ]
25}Possible Error Responses
Bad Request: Invalid job ID
Unauthorized: Invalid or missing API key
Not Found: Job not found
Internal Server Error: Server-side error
Job Statuses
draftTranscription job has been created but not yet submitted
not_startedTranscription job has been submited but not yet started
pendingTranscription will start soon
runningTranscription is in progress
speaker_labelingSpeaker labeling is in progress
completedTranscription is finished and available
failedTranscription failed due to an error partially or fully
canceledTranscription was canceled by the user
deletedTranscription was deleted by the user
Important Notes
The language parameter is optional. If not provided, the system will attempt to auto-detect the language.
The callback_url is optional. If provided, you will receive a webhook notification when the transcription is complete.
Make sure you have sufficient balance in your account before submitting transcription jobs.
Audio URLs must be publicly accessible. You can generate a pre-signed url if hosted on S3 or GCS for example.
The API supports various audio formats (MP3, WAV, etc.). Check the system documentation for supported formats.
SECURE & COMPLETELY CUSTOMIZED DATA TRANSCRIPTION FOR A VARIETY OF INDUSTRIES
