Convertorio SDK

Official SDKs for the Convertorio API - Convert images between 20+ formats with ease.

• ✅ Simple, intuitive APIs
• ✅ Support for 20+ image formats
• ✅ Automatic file upload and download
• ✅ Event-driven progress tracking
• ✅ Comprehensive error handling
• ✅ TypeScript support
• ✅ Well documented with examples

npm install convertorio-sdk

const ConvertorioClient = require('convertorio-sdk');

const client = new ConvertorioClient({
    apiKey: 'your_api_key_here'
});

const result = await client.convertFile({
    inputPath: './image.png',
    targetFormat: 'jpg'
});

console.log('Converted!', result.outputPath);

→ Full Node.js Documentation

pip install convertorio-sdk

from convertorio_sdk import ConvertorioClient

client = ConvertorioClient(api_key='your_api_key_here')

result = client.convert_file(
    input_path='./image.png',
    target_format='jpg'
)

print(f"Converted! {result['output_path']}")

→ Full Python Documentation

composer require convertorio/sdk

<?php

require 'vendor/autoload.php';

use Convertorio\SDK\ConvertorioClient;

$client = new ConvertorioClient('your_api_key_here');

$result = $client->convertFile(
    './image.png',
    'jpg'
);

echo "Converted! {$result['output_path']}";

→ Full PHP Documentation

go install github.com/SedeSoft/convertorio-sdk/libs/go

package main

import (
    "fmt"
    "log"
    convertorio "github.com/SedeSoft/convertorio-sdk/libs/go"
)

func main() {
    client := convertorio.NewClient(convertorio.ClientConfig{
        APIKey: "your_api_key_here",
    })

    result, err := client.ConvertFile(convertorio.ConvertFileOptions{
        InputPath:    "./image.png",
        TargetFormat: "jpg",
    })

    if err != nil {
        log.Fatal(err)
    }

    fmt.Printf("Converted! %s\n", result.OutputPath)
}

→ Full Go Documentation

<!-- Maven: Add to pom.xml -->
<dependency>
    <groupId>com.sedesoft</groupId>
    <artifactId>convertorio-sdk</artifactId>
    <version>1.2.0</version>
</dependency>

import com.sedesoft.convertorio.*;

public class Example {
    public static void main(String[] args) {
        try {
            ConvertorioClient client = new ConvertorioClient(
                ClientConfig.builder()
                    .apiKey("your_api_key_here")
                    .build()
            );

            ConversionResult result = client.convertFile(
                ConversionOptions.builder()
                    .inputPath("./image.png")
                    .targetFormat("jpg")
                    .build()
            );

            System.out.println("Converted! " + result.getOutputPath());
        } catch (ConvertorioException e) {
            System.err.println("Error: " + e.getMessage());
        }
    }
}

→ Full Java Documentation

gem install convertorio-sdk

require 'convertorio'

client = Convertorio::Client.new(api_key: 'your_api_key_here')

result = client.convert_file(
  input_path: './image.png',
  target_format: 'jpg'
)

puts "Converted! #{result[:output_path]}"

→ Full Ruby Documentation

dotnet add package Convertorio.SDK

using Convertorio.SDK;

using (var client = new ConvertorioClient("your_api_key_here"))
{
    var result = await client.ConvertFileAsync(new ConversionOptions
    {
        InputPath = "./image.png",
        TargetFormat = "jpg"
    });

    Console.WriteLine($"Converted! {result.OutputPath}");
}

→ Full .NET Documentation

The Node.js SDK provides a simple, promise-based API with event support for tracking conversion progress.

Installation:

npm install convertorio-sdk

Features:

• Promise-based async/await API
• Event emitters for progress tracking
• TypeScript definitions included
• Automatic file handling

→ View Node.js Documentation

→ View Node.js Examples

The Python SDK provides an intuitive API with event callbacks for tracking conversion progress.

Installation:

pip install convertorio-sdk

Features:

• Simple, synchronous API
• Event callbacks for progress tracking
• Type hints for IDE support
• Automatic file handling

→ View Python Documentation

→ View Python Examples

The PHP SDK provides a clean, PSR-4 compliant API with event callbacks for tracking conversion progress.

Installation:

composer require convertorio/sdk

Features:

• PSR-4 autoloading
• Event callbacks for progress tracking
• Compatible with modern PHP frameworks
• Automatic file handling
• Supports PHP 7.4+

→ View PHP Documentation

→ View PHP Examples

The Go SDK provides a type-safe, idiomatic Go API with event callbacks for tracking conversion progress.

Installation:

go install github.com/SedeSoft/convertorio-sdk/libs/go

Features:

• Type-safe API with structs
• Event callbacks for progress tracking
• No external dependencies (standard library only)
• Automatic file handling
• Supports Go 1.18+

→ View Go Documentation

→ View Go Examples

The Java SDK provides a type-safe API with builder patterns and event callbacks for tracking conversion progress.

Installation:

Maven:

<dependency>
    <groupId>com.sedesoft</groupId>
    <artifactId>convertorio-sdk</artifactId>
    <version>1.2.0</version>
</dependency>

Gradle:

implementation 'com.sedesoft:convertorio-sdk:1.2.0'

Features:

• Type-safe API with builder patterns
• Event callbacks for progress tracking
• Uses OkHttp and Gson (no external image libraries)
• Automatic file handling
• Supports Java 11+

→ View Java Documentation

→ View Java Examples

The Ruby SDK provides a clean, idiomatic Ruby API with event callbacks for tracking conversion progress.

Installation:

gem install convertorio-sdk

Features:

• Clean, idiomatic Ruby API
• Event callbacks for progress tracking
• HTTParty for HTTP requests
• Automatic file handling
• Supports Ruby 2.7+

→ View Ruby Documentation

→ View Ruby Examples

The .NET SDK provides a modern async/await API with event-driven progress tracking for all .NET platforms.

Installation:

dotnet add package Convertorio.SDK

Features:

• Modern async/await API
• Event-driven progress tracking
• IDisposable pattern for proper resource cleanup
• Full IntelliSense support with XML documentation
• Supports .NET Standard 2.0+ (.NET Core, .NET 5+, .NET Framework 4.6.1+)

→ View .NET Documentation

→ View .NET Examples

Want to see support for another language? Open an issue or contribute!

1. Sign up at convertorio.com
2. Go to your Account Settings
3. Generate an API key

Choose your preferred language and follow the installation instructions in the language-specific documentation.

Check out the examples in the examples/ directory for your chosen language.

Convert between 20+ image formats:

Common Formats:

• JPG/JPEG
• PNG
• WebP
• AVIF
• GIF
• BMP
• TIFF

Advanced Formats:

• HEIC/HEIF (iPhone photos)
• ICO (icons)
• SVG (vectors)
• RAW formats (CR2, NEF, DNG)
• PDF
• PSD (Photoshop)
• AI (Adobe Illustrator)
• EPS
• JXL (JPEG XL)

✨ AI-Powered OCR:

• Extract text from any image format
• Powered by advanced AI technology
• Support for printed and handwritten text
• JSON or TXT output formats

Extract text from images with state-of-the-art AI accuracy.

const result = await client.convertFile({
    inputPath: './invoice.jpg',
    targetFormat: 'ocr',
    outputPath: './invoice.json',
    conversionMetadata: {
        ocr_format: 'json',
        ocr_instructions: 'Extract invoice data including date, items, and total'
    }
});

console.log(`Extracted text, tokens used: ${result.tokensUsed}`);

result = client.convert_file(
    input_path='./receipt.jpg',
    target_format='ocr',
    output_path='./receipt.txt',
    conversion_metadata={
        'ocr_format': 'txt',
        'ocr_instructions': 'Extract all text from this receipt'
    }
)

print(f"Tokens used: {result['tokens_used']}")

$result = $client->convertFile(
    './document.jpg',
    'ocr',
    './document.json',
    [
        'ocr_format' => 'json',
        'ocr_instructions' => 'Extract form data as structured JSON'
    ]
);

echo "Tokens used: " . $result['tokens_used'];

result = client.convert_file(
  input_path: './form.jpg',
  target_format: 'ocr',
  output_path: './form.txt',
  conversion_metadata: {
    ocr_format: 'txt',
    ocr_instructions: 'Extract all text preserving formatting'
  }
)

puts "Tokens used: #{result[:tokens_used]}"

result, err := client.ConvertFile(convertorio.ConvertFileOptions{
    InputPath:    "./invoice.jpg",
    TargetFormat: "ocr",
    OutputPath:   "./invoice.json",
    ConversionMetadata: map[string]interface{}{
        "ocr_format":       "json",
        "ocr_instructions": "Extract invoice items and total",
    },
})

fmt.Printf("Tokens used: %d\n", result.TokensUsed)

ConversionResult result = client.convertFile(
    ConversionOptions.builder()
        .inputPath("./receipt.jpg")
        .targetFormat("ocr")
        .outputPath("./receipt.txt")
        .conversionMetadata(Map.of(
            "ocr_format", "txt",
            "ocr_instructions", "Extract receipt items and total"
        ))
        .build()
);

System.out.println("Tokens used: " + result.getTokensUsed());

var result = await client.ConvertFileAsync(new ConversionOptions
{
    InputPath = "./invoice.jpg",
    TargetFormat = "ocr",
    OutputPath = "./invoice.json",
    ConversionMetadata = new ConversionMetadata
    {
        OcrFormat = "json",
        OcrInstructions = "Extract invoice data with line items"
    }
});

Console.WriteLine($"Tokens used: {result.TokensUsed}");

• High Accuracy: Powered by advanced AI for state-of-the-art text recognition
• Multiple Languages: Automatic language detection and support
• Flexible Output: Choose between txt (plain text) or json (structured data)
• Custom Instructions: Guide the AI to extract specific information
• Handwriting Support: Recognizes both printed and handwritten text
• Table Recognition: Preserves table structure in extracted text
• Token-Based Billing: Pay only for what you use, with transparent token counts

• 📄 Invoice Processing: Extract structured data from invoices and receipts
• 📝 Form Digitization: Convert paper forms to digital data
• 📋 Document Archival: Make scanned documents searchable
• 🏷️ Label Reading: Extract text from product labels and tags
• ✍️ Handwriting Recognition: Digitize handwritten notes
• 📊 Table Extraction: Convert tables in images to structured data

For complete OCR documentation, see the language-specific README files.

*With purchased points

sdk/
├── src/               # PHP SDK source (root level for Packagist)
│   └── ConvertorioClient.php
├── libs/              # SDK implementations
│   ├── nodejs/        # Node.js SDK
│   ├── python/        # Python SDK
│   ├── php/           # PHP SDK
│   ├── go/            # Go SDK
│   ├── java/          # Java SDK
│   └── ruby/          # Ruby SDK
├── examples/          # Usage examples
│   ├── nodejs/        # Node.js examples
│   ├── python/        # Python examples
│   ├── php/           # PHP examples
│   ├── go/            # Go examples
│   ├── java/          # Java examples
│   └── ruby/          # Ruby examples
├── tests/             # Test suites
│   ├── nodejs/        # Node.js tests
│   ├── python/        # Python tests
│   ├── php/           # PHP tests
│   ├── go/            # Go tests
│   ├── java/          # Java tests
│   └── ruby/          # Ruby tests
├── docs/              # Documentation
│   ├── nodejs/        # Node.js documentation
│   ├── python/        # Python documentation
│   ├── php/           # PHP documentation
│   └── go/            # Go documentation
├── composer.json      # PHP package config (root level)
├── examples.php       # PHP examples (root level)
├── README.md          # This file
└── README-PHP.md      # PHP documentation

Each language SDK can be built independently. See the language-specific README for build instructions.

Navigate to the examples directory for your language:

# Node.js examples
cd examples/nodejs
node basic-conversion.js

# Python examples
cd examples/python
python basic_conversion.py

# PHP examples
php examples.php

# Go examples
cd examples/go
go run examples.go

# Java examples
cd examples/java
javac -cp ".:libs/*" Example.java
java -cp ".:libs/*" Example

# Ruby examples
cd examples/ruby
ruby basic_conversion.rb

# Node.js
cd libs/nodejs
npm test

# Python
cd test/python/simple-convert
python simple-test.py
python test-resize.py
python test-with-metadata.py

# PHP
cd test/php/simple-convert
php simple-test.php
php test-resize.php
php test-with-metadata.php

# Go
cd test/go/simple-convert
go run main.go

# Java
cd test/java/simple-convert
javac -cp ".:libs/*" SimpleTest.java
java -cp ".:libs/*" SimpleTest

# Ruby
cd tests/ruby
bundle install
bundle exec rspec

• Main Website: convertorio.com
• API Documentation: convertorio.com/api-docs
• Support: support@convertorio.com
• GitHub Repository: github.com/convertorio/sdk

We welcome contributions! Here's how you can help:

1. Report bugs - Open an issue describing the problem
2. Suggest features - Open an issue with your feature request
3. Submit pull requests - Fork, make changes, and submit a PR
4. Improve documentation - Help make the docs better
5. Add SDK for new language - Implement SDK for a language we don't support yet

See CONTRIBUTING.md for detailed guidelines.

All SDKs are released under the MIT License. See LICENSE for details.

• Star this repository to get notifications about new releases
• Follow us on Twitter
• Subscribe to our newsletter

Need help? Here are your options:

1. Documentation - Check the language-specific docs
2. Examples - Browse the examples directory
3. GitHub Issues - Open an issue
4. Email Support - support@convertorio.com
5. Community - Join our Discord server

Made with ❤️ by the Convertorio team