v1.0 Stable

CoreNexis Image Converter API

Auto-detect & convert images across formats — optimized for automation and business workflows. Fast, high-quality image conversion with automatic format detection.

Automatic Format Detection
Multi-Format Support
Fast Conversion
Automation Ready
High Quality Output
URL & Binary Input
Business Workflows
Production Ready API

This API is production-ready and optimized for automation workflows. Contact our team for enterprise plans with higher limits and SLA guarantees.

CoreNexis Image Converter API

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.

Key Features

  • Automatic format detection - No need to specify input format
  • Wide format support - Convert JPG, PNG, WebP, HEIC, AVIF, TIFF, SVG, ICO, BMP, GIF
  • Dual input methods - Upload files directly or provide image URLs
  • High-quality conversion - Optimized algorithms for best results
  • Fast processing - Quick turnaround for automation workflows
  • Automation ready - Perfect for business processes and integrations
  • Reliable delivery - Converted images served via CDN

Base URL

https://api.corenexis.com/image/converter/V1

Authentication

All API requests require authentication using a client ID and API key. These credentials determine your access level, rate limits, and usage quotas.

Sample API Credentials

You can see how corenexis api works:

Sample Credentials

Testing Credentials Notice

To obtain a testing key, please fill out the request form.

Supported Formats

Our API supports a wide range of image formats for both input and output, with automatic format detection for input files.

Input Formats (Auto-Detected)

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

Output Formats

You can convert to any of the following formats by specifying the output_format parameter:

jpg - Standard web format
png - Lossless with transparency
webp - Modern web format
avif - Next-gen compression
heic - Apple format
tiff - Professional format
svg - Vector format
ico - Icon format
bmp - Bitmap format
gif - Standard support

Endpoints

Convert Image

POST https://api.corenexis.com/image/converter/V1

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.

Request Parameters

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.

Response

A successful response will return a 200 status code and a JSON object with the following properties:

Success Response
{
  "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"
}

Response Fields

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

Examples

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.

File Upload Examples

Convert JPG to WebP

cURL Example
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"

Convert PNG to AVIF

cURL Example
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"

Convert HEIC to JPG

cURL Example
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"

URL Conversion Examples

Convert Remote Image to PNG

cURL Example
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"

Convert Web Image to Modern WebP

cURL Example
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"

Convert to ICO for Favicon

cURL Example
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"
Pro Tip

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!

Error Handling

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 Handling Best Practices

Always check the HTTP status code before processing the response
Implement retry logic for server errors (5xx) but not for client errors (4xx)
Respect rate limits and implement backoff when receiving 429 responses
Validate file formats and sizes before making API calls
Cache successful conversions to avoid redundant API calls

Example Error Response

Error Response
{
  "error": "This format not supported. Use only: JPG, JPEG, PNG, GIF, BMP, WebP, HEIC, HEIF, TIFF, TIF, SVG, ICO, AVIF",
  "status": "failed"
}

Contact & Support

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.

Getting Help

Email Support: [email protected]
General Inquiries: Contact Page

Enterprise & Production Plans

For business workflows and automation needs, we offer enterprise plans with:

  • Higher rate limits - Process thousands of images per hour
  • Larger file sizes - Support for files up to 100MB
  • SLA guarantees - 99.9% uptime commitment
  • Priority support - Dedicated technical assistance
  • Custom integrations - Tailored solutions for your workflow
  • Bulk conversion - Process multiple images in single requests
Integration Support

Our team can help you integrate the Image Converter API into your existing workflows and applications. Contact us for consultation and custom development services.