Table of Contents

Developer Guides

Comprehensive guides to help you integrate MediaConvert.io into your applications.

Getting Started

Getting Started Guide

Complete walkthrough from account setup to your first conversion, including authentication setup and basic API usage patterns.

Authentication Guide

API token management, authentication patterns, and security best practices for production applications.

Webhook Guide

Real-time notifications for job completion, progress tracking, and event-driven architectures.

Core Concepts

Supported Formats

MediaConvert.io supports 60+ input formats and 20+ output formats across video, image, audio, and document types.

Popular Conversions:
- Video: MP4, WebM, AVI, MOV, MKV → MP4, WebM, AVI
- Images: JPG, PNG, GIF, TIFF → WebP, JPG, PNG
- Audio: MP3, WAV, FLAC, AAC → MP3, AAC, OGG

Pricing Model

Volume-based pricing with micro-precision billing:
- Video: €0.003 per MB processed
- Images: €0.0015 per MB processed

- Audio: €0.002 per MB processed
- Documents: €0.001 per MB processed

Job Types and Urgency

Control processing priority with urgency levels:
- soon - High priority, immediate processing
- whenever - Standard queue processing

- can_wait - Low priority, cost-optimized

Integration Patterns

Presigned URLs

MediaConvert.io uses S3-compatible presigned URLs for secure file access:

1. Upload file to your S3 bucket
2. Generate presigned URLs for input and output
3. Submit conversion job with URLs
4. Worker downloads, processes, and uploads directly

Webhook Integration

Real-time job status updates via secure webhooks:

POST /your-webhook-endpoint
X-MediaConvert-Signature: sha256=...
{
"job_id": "job_abc123",
"status": "completed",
"cost_micros": 150000
}

Error Handling

Comprehensive error types for robust integration:
- AuthenticationError - Invalid API token
- InsufficientCreditsError - Not enough account balance
- ValidationError - Invalid request parameters
- RateLimitError - API rate limit exceeded
- ConversionError - Processing failed

Production Checklist

Before going live:
- ✅ Implement proper error handling for all scenarios
- ✅ Set up webhook signature verification
- ✅ Configure retry logic with exponential backoff
- ✅ Add job progress monitoring and timeouts
- ✅ Implement credit balance monitoring
- ✅ Set up logging and monitoring

Next Steps

  1. Code Examples - Copy-paste ready integration code
  2. API Reference - Complete API documentation
  3. Try It Live - Interactive API testing

Need Help?