Introduction

🎤 MediaTranscribe Transcription API

Transform audio & video into searchable, actionable text with AI-powered precision

🚀 What is MediaTranscribe?

MediaTranscribe is a cutting-edge transcription API that converts audio and video content into accurate, searchable text using advanced AI and Natural Language Processing (NLP) technologies. Whether you're working with podcasts, meetings, interviews, or video content, our API delivers high-quality transcriptions with context-aware understanding.

✨ Key Features

• 🎯 High Accuracy: Advanced speech recognition with 95%+ accuracy

• 🌍 Multi-Language Support: 60+ languages and dialects

• ⚡ Real-time Processing: Lightning-fast transcription with live status updates

• 🤖 AI-Powered Analysis: Sentiment analysis, entity recognition, and content insights

• 📊 Rich Metadata: Detailed analytics, timestamps, and speaker identification

• 🔒 Privacy First: End-to-end encryption, no data storage

• 🔄 Multiple Input Sources: File upload, URL, YouTube, and direct streaming

---

🛠️ Quick Start

To start using MediaTranscribe, you'll need to obtain your API key. Visit our dashboard settings page where you can generate and manage your API keys. This key is essential for authenticating your requests and accessing our transcription services.

Upload & Transcribe

// JavaScript Example
const formData = new FormData();
formData.append('file', audioFile);
formData.append('language', 'en');
formData.append('services', 'transcription,sentiment,chapters');

const response = await fetch('https://api.mediatranscribe.com/api/v1/transcribes/', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'multipart/form-data',
  },
  body: formData
});

const result = await response.json();
console.log('Transcription data:', result.data);

3. YouTube Transcription

# Python Example
import requests

url = "https://api.mediatranscribe.com/api/v1/transcribes/youtube/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}
data = {
    "youtube_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "language": "en",
    "services": "transcription,sentiment,chapters"
}

response = requests.post(url, headers=headers, json=data)
transcription = response.json()
print(f"Transcription: {transcription['data']['transcript']}")

---

📡 API Endpoints

Core Transcription Endpoints

Endpoint	Method	Description
/transcribes/	POST	Upload and transcribe media files
/transcribes/youtube/	POST	Transcribe YouTube videos
/transcribes/media/	POST	Transcribe from media URLs
/transcribes/{uuid}	GET	Get transcription details
/transcribes/{uuid}	PUT	Update transcription metadata
/transcribes/chat/{uuid}	POST	AI chat with transcription

🎯 Supported Formats

Audio Formats

✅ MP3, WAV, FLAC, AAC, M4A, OGG, WMA, OPUS

Video Formats

✅ MP4, AVI, MKV, MOV, WMV, FLV, 3GP, WebM

Input Methods

📁 File Upload (up to 2GB)
🔗 Direct URLs
📺 YouTube Links

---

🔧 Advanced Usage

1. Multi-Service Processing

// Request multiple AI services in one call
// Request multiple AI services in a single API call
const services = [
  'transcription',        // Convert audio/video to text
  'title',                // Generate a suitable title
  'summary',              // Summarize the content
  'chapters',             // Auto-generate chapters or sections
  'hatespeech-detection', // Detect hate or toxic language
  'meeting-notes',        // Extract structured meeting insights
  'social-media-posts',   // Create content for social platforms
  'tags',                 // Generate relevant tags or topics
  'blog-posts',           // Create blog-ready content
  'sentiment-analysis',   // Analyze emotions and sentiment
  'keywords',             // Extract important keywords
  'language-detection',   // Detect spoken or written language
  'subtitles',            // Generate SRT subtitle files
  'tweets'                // Generate tweet-length summaries
];

const requestBody = {
  file: audioFile,
  language: 'en',
  services: services.join(',')
};

2. Real-time Status Monitoring

// Poll for processing status
const checkStatus = async (uuid) => {
  const response = await fetch(`/transcribes/${uuid}`);
  const data = await response.json();
  
  console.log(`Status: ${data.status}`);
  console.log(`Progress: ${data.processing_percentage}%`);
  
  if (data.status === 'completed') {
    console.log('Transcription ready!');
    console.log(data.transcript);
  }
};

// Check every 5 seconds
setInterval(() => checkStatus(uuid), 5000);

3. AI Chat Integration

// Chat with your transcription using AI
const chatWithTranscription = async (uuid, question) => {
  const response = await fetch(`/transcribes/chat/${uuid}`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer YOUR_API_KEY'
    },
    body: JSON.stringify({
      prompt: question
    })
  });
  
  const result = await response.json();
  return result.data.answer;
};

// Example usage
const answer = await chatWithTranscription(
  'transcription-uuid',
  'What were the main action items discussed?'
);

---

📊 Response Structure

Complete Transcription Response

{
  "status": 200,
  "detail": "Transcription completed successfully",
  "data": {
    "uuid": "abc123-def456-ghi789",
    "title": "Meeting Recording",
    "type": "audio",
    "size": "15.2 MB",
    "duration": "00:45:30",
    "language": "en",
    "status": "completed",
    "processing_percentage": 100,
    
    // Core transcription
    "transcript": "Hello everyone, welcome to our weekly meeting...",
    "transcript_segments": [
      {
        "id": 1,
        "start": 0.0,
        "end": 3.5,
        "text": "Hello everyone, welcome to our weekly meeting",
        "seek": 0
      }
    ],
    
    // AI-powered insights
    "sentiment_analysis": {
      "overall_sentiment": "positive",
      "sentiment_score": 0.75,
      "dominant_emotions": ["excited", "confident"],
      "segments": [...]
    },
    
    "chapters": [
      {
        "time": "00:05:30",
        "title": "Project Updates",
        "content": "Discussion about current project status...",
        "summary": "Team provided updates on ongoing projects"
      }
    ],
    
    "meeting_notes": {
      "date": "2024-01-15",
      "time": "10:00 AM",
      "purpose": "Weekly team sync",
      "outcomes": "Decided on new feature priorities",
      "action_items": [
        {
          "task": "Implement user authentication",
          "owner": "John Doe",
          "deadline": "2024-01-22"
        }
      ]
    },
    
    "keywords": ["API", "authentication", "security", "deployment"],
    "topics": ["Software Development", "Project Management"],
    
    // Generated content
    "blog_posts": [...],
    "tweets": [...],
    "subtitle": "WEBVTT\n\n00:00:00.000 --> 00:00:03.500\nHello everyone, welcome to our weekly meeting...",
    "subtitle_file": "https://api.mediatranscribe.com/subtitles/abc123.srt",
    // ...
  }
}

---

🌍 Language Support

Supported Languages

| Code  | Language                       | Flag         |
| ----- | ------------------------------ | ------------ |
| auto  | Automatic Detection            | 🌍           |
| af    | Afrikaans                      | 🇿🇦         |
| sq    | Albanian                       | 🇦🇱         |
| am    | Armenian                       | 🇦🇲         |
| az    | Azerbaijani                    | 🇦🇿         |
| be    | Belarusian                     | 🇧🇾         |
| bn    | Bengali                        | 🇧🇩         |
| bs    | Bosnian                        | 🇧🇦         |
| bg    | Bulgarian                      | 🇧🇬         |
| ca    | Catalan                        | 🇪🇸         |
| zh-CN | Mandarin (Simplified, China)   | 🇨🇳         |
| zh-TW | Mandarin (Traditional, Taiwan) | 🇹🇼         |
| hr    | Croatian                       | 🇭🇷         |
| cs    | Czech                          | 🇨🇿         |
| da    | Danish                         | 🇩🇰         |
| nl    | Dutch                          | 🇳🇱         |
| en    | English                        | 🇬🇧🇺🇸🇦🇺 |
| et    | Estonian                       | 🇪🇪         |
| fi    | Finnish                        | 🇫🇮         |
| fr    | French                         | 🇫🇷🇨🇦🇸🇳 |
| gl    | Galician                       | 🇪🇸         |
| ka    | Georgian                       | 🇬🇪         |
| de    | German                         | 🇩🇪🇦🇹🇨🇭 |
| el    | Greek                          | 🇬🇷         |
| gu    | Gujarati                       | 🇮🇳         |
| he    | Hebrew                         | 🇮🇱         |
| hi    | Hindi                          | 🇮🇳         |
| hu    | Hungarian                      | 🇭🇺         |
| is    | Icelandic                      | 🇮🇸         |
| id    | Indonesian                     | 🇮🇩         |
| it    | Italian                        | 🇮🇹         |
| ja    | Japanese                       | 🇯🇵         |
| kn    | Kannada                        | 🇮🇳         |
| kk    | Kazakh                         | 🇰🇿         |
| ko    | Korean                         | 🇰🇷         |
| lv    | Latvian                        | 🇱🇻         |
| lt    | Lithuanian                     | 🇱🇹         |
| ml    | Malayalam                      | 🇮🇳         |
| mr    | Marathi                        | 🇮🇳         |
| mk    | Macedonian                     | 🇲🇰         |
| ms    | Malay                          | 🇲🇾🇸🇬     |
| no    | Norwegian                      | 🇳🇴         |
| fa    | Persian (Farsi)                | 🇮🇷         |
| pl    | Polish                         | 🇵🇱         |
| pt    | Portuguese                     | 🇵🇹🇧🇷     |
| pa    | Punjabi                        | 🇮🇳🇵🇰     |
| ro    | Romanian                       | 🇷🇴         |
| ru    | Russian                        | 🇷🇺         |
| sr    | Serbian                        | 🇷🇸         |
| sk    | Slovak                         | 🇸🇰         |
| sl    | Slovenian                      | 🇸🇮         |
| es    | Spanish                        | 🇪🇸🇲🇽🇨🇴 |
| sw    | Swahili                        | 🇰🇪🇹🇿     |
| sv    | Swedish                        | 🇸🇪         |
| ta    | Tamil                          | 🇮🇳🇱🇰     |
| te    | Telugu                         | 🇮🇳         |
| th    | Thai                           | 🇹🇭         |
| tr    | Turkish                        | 🇹🇷         |
| uk    | Ukrainian                      | 🇺🇦         |
| ur    | Urdu                           | 🇵🇰🇮🇳     |
| vi    | Vietnamese                     | 🇻🇳         |
| cy    | Welsh                          | 🏴           |

Language Detection

// Auto-detect language
const requestBody = {
  file: audioFile,
  language: 'auto',  // Automatic language detection
  services: 'transcription'
};

---

🔒 Security & Privacy

Data Protection

• 🔐 End-to-End Encryption: All data encrypted in transit and at rest

• 🗑️ No Data Storage: Files deleted after processing. Feel free to

• 🔑 API Key Authentication: Secure access control

📈 Performance & Limits

Processing Speeds

File Duration	Processing Time	Real-time Factor
1 minute	~30 seconds	2x faster
10 minutes	~4 minutes	2.5x faster
1 hour	~20 minutes	3x faster
2 hours	~35 minutes	3.4x faster

Rate Limits

Free Tier:     1,000 requests/min
Starter:       5,000 requests/min
Professional:  10,000 requests/min
Enterprise:    Unlimited

---

🛠️ SDKs & Libraries

Coming soon...

---

🎯 Use Cases

🎙️ Podcast Production

// Generate show notes, chapters, and social media content
const podcastServices = [
  'transcription',
  'chapters',
  'summary',
  'blog_post',
  'tweets'
];

📊 Meeting Intelligence

// Extract action items, decisions, and insights
const meetingServices = [
  'transcription',
  'meeting_notes',
  'sentiment',
  'keywords'
];

🎬 Video Content

// Create subtitles, descriptions, and SEO content
const videoServices = [
  'transcription',
  'subtitle',
  'summary',
  'keywords',
  'blog_post'
];

🎓 Educational Content

// Generate study materials and summaries
const educationServices = [
  'transcription',
  'chapters',
  'summary',
  'keywords',
  'meeting_notes'
];

---

🚀 Getting Started

1. Sign Up

Visit mediatranscribe.com and create your account.

2. Get API Key

Navigate to your dashboard and generate your API key.

3. Choose Your Plan

Select the plan that fits your needs:

• Basic: 10 transcriptions/month

• Starter: 100 transcriptions

• Professional: $99/month - 1,000 transcriptions

• Enterprise: Custom pricing

4. Start Transcribing

Use our API or SDK to start transcribing your content!

---

📞 Support & Community

• 📚 Documentation: docs.mediatranscribe.com

• 💬 Community: Telegram

• 🐛 Issues: GitHub Issues

• 📧 Support: [email protected]

• 📱 Status: status.mediatranscribe.com

---

🔄 Changelog

v2.1.0 (Latest)

• ✨ Added real-time streaming support

• 🎯 Improved accuracy by 15%

• 🌍 Added 20 new languages

• 🔧 Enhanced API response times

v2.0.0

• 🚀 Complete API redesign

• 🤖 Advanced AI features

• 📊 Rich analytics and insights

• 🔒 Enhanced security features

---

Ready to transform your audio and video content? Get started now!

---

Built with ❤️ by the MediaTranscribe team