✦ LUXURY REST API v2
Integrate luxury HDR
into your workflow
Simple, scalable API for premium automated HDR mastering optimized for all social media platforms.
Get API KeysQuick start
curl -X POST https://api.luxhdr.top/v1/convert/hdr \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input_url": "https://your-storage.com/video.mp4",
"platform": "social_media",
"target_nits": 600,
"callback_url": "https://your-api.com/webhook"
}'
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input_url": "https://your-storage.com/video.mp4",
"platform": "social_media",
"target_nits": 600,
"callback_url": "https://your-api.com/webhook"
}'
Endpoints
POST /v1/convert/hdr
Submit a video for luxury HDR conversion. Returns job_id for tracking.
{ "job_id": "hdr_abc123xyz", "status": "processing", "estimated_completion": "2025-01-15T14:30:00Z" }
GET /v1/jobs/{job_id}
Check job status and get output URLs when complete.
{ "job_id": "hdr_abc123xyz", "status": "completed", "output_url": "https://cdn.luxhdr.top/output/hdr_abc123xyz.mp4", "metadata": { "bitrate": "15 Mbps", "codec": "HEVC Main10", "color_space": "Rec.2020 ST.2084" } }
GET /v1/platforms
List all supported social platforms with their HDR specifications.
[ {"platform": "global_social", "max_nits": 800, "codec": "H.265", "color": "PQ"}, {"platform": "short_form", "max_nits": 600, "codec": "H.265", "color": "PQ"}, {"platform": "vertical_video", "max_nits": 1000, "codec": "H.265/VP9", "color": "PQ"}, {"platform": "regional_network", "max_nits": 800, "codec": "H.265", "color": "HLG/PQ"} ]
Authentication
All API requests require a Bearer token. Request API credentials for your enterprise account.
Authorization: Bearer your_api_key_here
Webhooks
Configure a callback URL to receive real-time notifications when conversion completes.
POST https://your-api.com/webhook
{ "event": "job.completed", "job_id": "hdr_abc123xyz", "output_url": "https://cdn.luxhdr.top/output/..." }
{ "event": "job.completed", "job_id": "hdr_abc123xyz", "output_url": "https://cdn.luxhdr.top/output/..." }
Ready to integrate luxury HDR?
Get your API keys and start converting videos in minutes.
Contact sales for API access