API Documentation

Authentication

Include your API key in the request header:

Authorization: Bearer YOUR_API_KEY

Base URL

https://transcribe.appwt.com/api

Upload File

POST /api/upload

Upload an audio or video file for transcription.

Request

curl -X POST https://transcribe.appwt.com/api/upload \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/audio.mp3"

Response

{
  "success": true,
  "job_id": "job_20260130_123456_abc123",
  "message": "File uploaded successfully",
  "file_name": "audio.mp3",
  "file_size": "5.2 MB"
}

Check Status

GET /api/status?job_id=JOB_ID

Check the status of a transcription job.

Response (Processing)

{
  "success": true,
  "status": "processing",
  "message": "Transcription in progress..."
}

Response (Completed)

{
  "success": true,
  "status": "completed",
  "transcript": "Your transcribed text here...",
  "language": "en",
  "duration": 45
}

Download Transcript

GET /api/download?job_id=JOB_ID&format=FORMAT

Download the transcript in various formats.

Available Formats

• txt - Plain text
• srt - SubRip subtitles
• vtt - WebVTT captions
• json - Structured JSON with timestamps

Rate Limits

Error Codes