Transgate API Documentation

1. Submit Transcription Job (URL)

Submit an audio file for transcription by providing its URL.

POST /api/v1/transcriptions/url

1{
2  "audio_url": "https://example.com/audio.mp3",
3  "language": "Azerbaijani",  // Optional
4  "callback_url": "https://your-callback-url.com/webhook"  // Optional
5}

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  }'

1{
2  "job_id": "123"
3}

2. Get Transcription Status and Results

Retrieve the status and results of a transcription job.

GET /api/v1/transcriptions/[job_id]

1curl -X GET https://transgate.ai/api/v1/transcriptions/123 \
2  -H "Authorization: Bearer YOUR_API_KEY"

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  "segments": [
10    {
11      "start_time": "00:00:00",
12      "end_time": "00:00:05",
13      "segment": "Hello, this is the first segment of the transcription."
14    }
15  ]
16}

Job Statuses

• draft: Transcription job has been created but not yet submitted
• not_started: Transcription job has been submited but not yet started
• pending: Transcription will start soon
• running: Transcription is in progress
• completed: Transcription is finished and available
• failed: Transcription failed due to an error partially or fully
• canceled: Transcription was canceled by the user
• deleted: Transcription was deleted by the user

Notes

1. The language parameter is optional. If not provided, the system will attempt to auto-detect the language.
2. The callback_url is optional. If provided, you will receive a webhook notification when the transcription is complete.
3. Make sure you have sufficient balance in your account before submitting transcription jobs.
4. Audio URLs must be publicly accessible. You can generate a pre-signed url if hosted on S3 or GCS for example.
5. The API supports various audio formats (MP3, WAV, etc.). Check the system documentation for supported formats.