Auto-detect & convert images across formats — optimized for automation and business workflows. Fast, high-quality image conversion with automatic format detection.
This API is production-ready and optimized for automation workflows. Contact our team for enterprise plans with higher limits and SLA guarantees.
The CoreNexis Image Converter API provides powerful image format conversion capabilities with automatic format detection. Convert images seamlessly between formats like JPG, PNG, WebP, HEIC, and more — perfect for automation and business workflows.
All API requests require authentication using a client ID and API key. These credentials determine your access level, rate limits, and usage quotas.
You can see how corenexis api works:
To obtain a testing key, please fill out the request form.
Our API supports a wide range of image formats for both input and output, with automatic format detection for input files.
Format | Extensions | Description |
---|---|---|
JPEG | .jpg, .jpeg, .jfif | Standard compressed image format |
PNG | .png | Lossless compression with transparency support |
WebP | .webp | Modern web format with excellent compression |
HEIC/HEIF | .heic, .heif | High efficiency format used by Apple devices |
AVIF | .avif | Next-generation format with superior compression |
TIFF | .tiff, .tif | Professional format with lossless compression |
SVG | .svg | Vector graphics format |
ICO | .ico | Icon format for favicons and applications |
BMP | .bmp | Bitmap format |
GIF | .gif | Graphics interchange format support |
You can convert to any of the following formats by specifying the output_format
parameter:
This endpoint converts images between different formats. You can either upload an image file directly or provide a URL to an existing image. The API automatically detects the input format.
Parameter | Type | Description |
---|---|---|
client_id Required | String | Your client ID for authentication |
api_key Required | String | Your API key for authentication |
output_format Required | String |
Target format for conversion. Supported values:
jpg , png , webp , avif , heic , tiff , svg , ico , bmp , gif
|
image Optional* | File | The image file to convert (Required if image_url is not provided) |
image_url Optional* | String | URL of an image to download and convert (Required if image is not provided) |
* Either image
or image_url
must be provided, but not both.
A successful response will return a 200 status code and a JSON object with the following properties:
{
"status": "success",
"url": "https://api.corenexis.com/cdn/api/image/image_converter/123/converted_image.webp",
"filesize": "45.2 KB",
"dimension": "800x600",
"expiry_time": "2025-06-24 14:30:00"
}
Field | Type | Description |
---|---|---|
status | String | Response status - "success" for successful conversions |
url | String | Direct CDN URL to the converted image |
filesize | String | File size of the converted image (e.g., "45.2 KB") |
dimension | String | Image dimensions in width x height format (e.g., "800x600") |
expiry_time | String | When the converted image will expire and be automatically deleted |
Here are practical examples of how to use the Image Converter API using cURL commands. These examples demonstrate both file upload and URL-based conversion methods.
curl -X POST https://api.corenexis.com/image/converter/V1/ \
-F "client_id=your_id" \
-F "api_key=your_key" \
-F "output_format=webp" \
-F "image=@/path/to/image.jpg"
curl -X POST https://api.corenexis.com/image/converter/V1/ \
-F "client_id=your_id" \
-F "api_key=your_key" \
-F "output_format=avif" \
-F "image=@/path/to/image.png"
curl -X POST https://api.corenexis.com/image/converter/V1/ \
-F "client_id=your_id" \
-F "api_key=your_key" \
-F "output_format=jpg" \
-F "image=@/path/to/image.heic"
curl -X POST https://api.corenexis.com/image/converter/V1/ \
-F "client_id=your_id" \
-F "api_key=your_key" \
-F "output_format=png" \
-F "image_url=https://example.com/image.jpg"
curl -X POST https://api.corenexis.com/image/converter/V1/ \
-F "client_id=your_id" \
-F "api_key=your_key" \
-F "output_format=webp" \
-F "image_url=https://cdn.example.com/large-image.png"
curl -X POST https://api.corenexis.com/image/converter/V1/ \
-F "client_id=your_id" \
-F "api_key=your_key" \
-F "output_format=ico" \
-F "image_url=https://example.com/logo.png"
The API automatically detects the input format, so you don't need to specify it. Just focus on the target format you want to convert to!
The API uses standard HTTP status codes to indicate the success or failure of a request. Here are the common error responses you might encounter:
Status Code | Description | Example Response |
---|---|---|
400 | Bad Request - Missing required parameters | {"error": "Client ID and API Key required", "status": "failed"} |
400 | Invalid output format | {"error": "This format not supported. Use only: JPG, PNG, WebP...", "status": "failed"} |
400 | No image provided | {"error": "Either upload an image file or provide image_url", "status": "failed"} |
400 | File size exceeds limit | {"error": "File size exceeds limit", "status": "failed"} |
401 | Invalid API key | {"error": "Wrong API key", "status": "failed"} |
403 | Account suspended or service not activated | {"error": "Service not activated", "status": "failed"} |
404 | Client not found | {"error": "Client not found", "status": "failed"} |
429 | Rate limit exceeded | {"error": "Rate limit reached", "status": "failed"} |
500 | Internal server error | {"error": "Conversion failed with all available methods", "status": "failed"} |
{
"error": "This format not supported. Use only: JPG, JPEG, PNG, GIF, BMP, WebP, HEIC, HEIF, TIFF, TIF, SVG, ICO, AVIF",
"status": "failed"
}
Need help with the Image Converter API or want to upgrade to a production plan with higher limits? We're here to assist you with integration and scaling.
For business workflows and automation needs, we offer enterprise plans with:
Our team can help you integrate the Image Converter API into your existing workflows and applications. Contact us for consultation and custom development services.