HQMX Converter API

Convert files programmatically with our powerful RESTful API

Quick Start

The HQMX Converter API allows you to convert files between different formats programmatically. Perfect for developers building applications that need file conversion capabilities.

Base URL

https://api.hqmx.net/converter

Authentication

Currently, our API uses rate limiting by IP address. For production usage and higher limits, please contact us at [email protected].

API Endpoints

Convert File

POST /convert

Upload a file and convert it to the specified format.

Parameters

Parameter Type Status Description
file File Required The file to convert (multipart/form-data)
target_format String Required Target format (e.g., "pdf", "jpg", "png", "mp4")
quality String Optional Output quality: "low", "medium", "high" (default: "high")

Example Request (cURL)

curl -X POST https://api.hqmx.net/converter/convert \ -F "file=@/path/to/your/file.png" \ -F "target_format=jpg" \ -F "quality=high"

Example Request (Python)

import requests url = "https://api.hqmx.net/converter/convert" files = {"file": open("document.png", "rb")} data = { "target_format": "jpg", "quality": "high" } response = requests.post(url, files=files, data=data) if response.status_code == 200: with open("converted.jpg", "wb") as f: f.write(response.content)

Example Request (JavaScript/Node.js)

const FormData = require('form-data'); const fs = require('fs'); const axios = require('axios'); const form = new FormData(); form.append('file', fs.createReadStream('document.png')); form.append('target_format', 'jpg'); form.append('quality', 'high'); axios.post('https://api.hqmx.net/converter/convert', form, { headers: form.getHeaders(), responseType: 'stream' }).then(response => { response.data.pipe(fs.createWriteStream('converted.jpg')); });

Response

On success, returns the converted file as binary data with appropriate content-type header.

Content-Type: image/jpeg Content-Disposition: attachment; filename="converted.jpg" [Binary file data]

Rate Limits & Usage

Free Tier (No Registration)

  • 28 requests per day per IP address
  • Max file size: 50MB
  • All supported formats
  • Rate limit resets at midnight UTC

Need More?

For higher limits, custom solutions, or enterprise support, contact us at [email protected]. We offer:

  • Custom rate limits
  • Priority processing
  • Dedicated support
  • SLA guarantees
  • White-label solutions

Pricing

Free

$0/month
  • 28 requests/day
  • 50MB max file size
  • All formats
  • Community support
Get Started

Supported Formats

Images

JPG, PNG, GIF, BMP, WEBP, TIFF, SVG, ICO

Documents

PDF, DOCX, DOC, TXT, RTF, ODT, XLSX, XLS, PPTX, PPT

Videos

MP4, AVI, MOV, MKV, WEBM, FLV, WMV

Audio

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

Error Handling

Status Code Meaning Description
200 OK Conversion successful
400 Bad Request Invalid parameters or file format
413 Payload Too Large File exceeds size limit
429 Too Many Requests Rate limit exceeded (28/day for free tier)
500 Internal Server Error Conversion failed, please retry

Contact & Support

Have questions or need custom solutions? We're here to help!

  • Email: [email protected]
  • Response Time: Within 24 hours
  • Payment Methods: Bank Transfer, PayPal (negotiable)

For Enterprise Inquiries: Please include your use case, expected volume, and budget in your email.