npm install convertorio-sdk

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

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

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

console.log('Conversion completed:', result.jobId);

client.on('progress', (data) => {
    console.log(`${data.step}: ${data.message}`);
});

client.on('complete', (result) => {
    console.log(`Done in ${result.processingTime}ms`);
});

await client.convertFile({
    inputPath: './document.pdf',
    targetFormat: 'png'
});

// Example 1: Convert to 16:9 widescreen
await client.convertFile({
    inputPath: './photo.jpg',
    targetFormat: 'webp',
    conversionMetadata: {
        aspect_ratio: '16:9',      // 1:1, 4:3, 16:9, 9:16, 21:9, custom
        crop_strategy: 'crop-center', // fit, crop-center, crop-top, etc.
        quality: 85                // 1-100 (for JPG, WebP, AVIF)
    }
});

// Example 2: Create square image for Instagram
await client.convertFile({
    inputPath: './photo.jpg',
    targetFormat: 'jpg',
    conversionMetadata: {
        aspect_ratio: '1:1',
        crop_strategy: 'crop-center',
        quality: 90
    }
});

// Example 3: Create ICO favicon
await client.convertFile({
    inputPath: './logo.png',
    targetFormat: 'ico',
    conversionMetadata: {
        icon_size: 32,            // 16, 32, 48, 64, 128, 256
        crop_strategy: 'crop-center'
    }
});

// Extract text from an invoice image
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(`Tokens used: ${result.tokensUsed}`);
console.log(`Extracted text saved to: ${result.outputPath}`);

pip install convertorio-sdk

from convertorio_sdk import ConvertorioClient

client = ConvertorioClient(api_key='your_api_key_here')

# Convert an image
result = client.convert_file(
    input_path='./image.png',
    target_format='jpg',
    output_path='./image.jpg'
)

print(f'Conversion completed: {result["job_id"]}')

def on_progress(data):
    print(f"{data['step']}: {data['message']}")

def on_complete(result):
    print(f"Done in {result['processing_time']}ms")

client.on('progress', on_progress)
client.on('complete', on_complete)

result = client.convert_file(
    input_path='./document.pdf',
    target_format='png'
)

# Example 1: Convert to 16:9 widescreen
result = client.convert_file(
    input_path='./photo.jpg',
    target_format='webp',
    conversion_metadata={
        'aspect_ratio': '16:9',      # 1:1, 4:3, 16:9, 9:16, 21:9, custom
        'crop_strategy': 'crop-center', # fit, crop-center, crop-top, etc.
        'quality': 85                # 1-100 (for JPG, WebP, AVIF)
    }
)

# Example 2: Create square image for Instagram
result = client.convert_file(
    input_path='./photo.jpg',
    target_format='jpg',
    conversion_metadata={
        'aspect_ratio': '1:1',
        'crop_strategy': 'crop-center',
        'quality': 90
    }
)

# Example 3: Create ICO favicon
result = client.convert_file(
    input_path='./logo.png',
    target_format='ico',
    conversion_metadata={
        'icon_size': 32,            # 16, 32, 48, 64, 128, 256
        'crop_strategy': 'crop-center'
    }
)

# Example 4: Resize image (v1.2.0+)
result = client.convert_file(
    input_path='./photo.jpg',
    target_format='jpg',
    conversion_metadata={
        'resize_width': 800,        # Width in pixels (1-10000)
        'resize_height': 600,       # Height in pixels (1-10000)
        'quality': 90
    }
)

# Extract text from a receipt image
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']}")
print(f"Extracted text saved to: {result['output_path']}")

composer require convertorio/sdk

<?php

require 'vendor/autoload.php';

use Convertorio\SDK\ConvertorioClient;

$client = new ConvertorioClient('your_api_key_here');

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

echo "Conversion completed: {$result['job_id']}";

$client->on('progress', function($data) {
    echo "{$data['step']}: {$data['message']}\n";
});

$client->on('complete', function($result) {
    echo "Done in {$result['processing_time']}ms\n";
});

$result = $client->convertFile(
    './document.pdf',
    'png'
);

// Example 1: Convert to 16:9 widescreen
$result = $client->convertFile(
    './photo.jpg',
    'webp',
    null,
    [
        'aspect_ratio' => '16:9',      // 1:1, 4:3, 16:9, 9:16, 21:9, custom
        'crop_strategy' => 'crop-center', // fit, crop-center, crop-top, etc.
        'quality' => 85                // 1-100 (for JPG, WebP, AVIF)
    ]
);

// Example 2: Create square image for Instagram
$result = $client->convertFile(
    './photo.jpg',
    'jpg',
    null,
    [
        'aspect_ratio' => '1:1',
        'crop_strategy' => 'crop-center',
        'quality' => 90
    ]
);

// Example 3: Create ICO favicon
$result = $client->convertFile(
    './logo.png',
    'ico',
    null,
    [
        'icon_size' => 32,            // 16, 32, 48, 64, 128, 256
        'crop_strategy' => 'crop-center'
    ]
);

// Example 4: Resize image (v1.2.0+)
$result = $client->convertFile(
    './photo.jpg',
    'jpg',
    null,
    [
        'resize_width' => 800,        // Width in pixels (1-10000)
        'resize_height' => 600,       // Height in pixels (1-10000)
        'quality' => 90
    ]
);

// Extract text from a document image
$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'] . "\n";
echo "Extracted text saved to: " . $result['output_path'];

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",
        OutputPath:   "./image.jpg",
    })

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

    fmt.Printf("Conversion completed: %s\n", result.JobID)
}

client.On("progress", func(data map[string]interface{}) {
    fmt.Printf("%s: %s\n", data["step"], data["message"])
})

client.On("complete", func(data map[string]interface{}) {
    fmt.Printf("Done in %dms\n", data["processing_time"])
})

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

// Example 1: Convert to 16:9 widescreen
result, _ := client.ConvertFile(convertorio.ConvertFileOptions{
    InputPath:    "./photo.jpg",
    TargetFormat: "webp",
    ConversionMetadata: map[string]interface{}{
        "aspect_ratio":  "16:9",       // 1:1, 4:3, 16:9, 9:16, 21:9, custom
        "crop_strategy": "crop-center", // fit, crop-center, crop-top, etc.
        "quality":       85,            // 1-100 (for JPG, WebP, AVIF)
    },
})

// Example 2: Create square image for Instagram
result, _ := client.ConvertFile(convertorio.ConvertFileOptions{
    InputPath:    "./photo.jpg",
    TargetFormat: "jpg",
    ConversionMetadata: map[string]interface{}{
        "aspect_ratio":  "1:1",
        "crop_strategy": "crop-center",
        "quality":       90,
    },
})

// Example 3: Create ICO favicon
result, _ := client.ConvertFile(convertorio.ConvertFileOptions{
    InputPath:    "./logo.png",
    TargetFormat: "ico",
    ConversionMetadata: map[string]interface{}{
        "icon_size":     32,            // 16, 32, 48, 64, 128, 256
        "crop_strategy": "crop-center",
    },
})

// Example 4: Resize image (v1.2.0+)
result, _ := client.ConvertFile(convertorio.ConvertFileOptions{
    InputPath:    "./photo.jpg",
    TargetFormat: "jpg",
    ConversionMetadata: map[string]interface{}{
        "resize_width":  800,  // Width in pixels (1-10000)
        "resize_height": 600,  // Height in pixels (1-10000)
        "quality":       90,
    },
})

// Extract text from an invoice image
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",
    },
})
if err != nil {
    log.Fatal(err)
}

fmt.Printf("Tokens used: %d\n", result.TokensUsed)
fmt.Printf("Extracted text saved to: %s\n", result.OutputPath)

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

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

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")
                    .outputPath("./image.jpg")
                    .build()
            );

            System.out.println("Conversion completed: " + result.getJobId());
        } catch (ConvertorioException e) {
            System.err.println("Error: " + e.getMessage());
        }
    }
}

client.on("progress", data -> {
    System.out.println(data.getString("step") + ": " + data.getString("message"));
});

client.on("complete", data -> {
    System.out.println("Done in " + data.getLong("processingTime") + "ms");
});

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

import java.util.HashMap;
import java.util.Map;

// Example 1: Convert to 16:9 widescreen
Map<String, Object> metadata1 = new HashMap<>();
metadata1.put("aspect_ratio", "16:9");       // 1:1, 4:3, 16:9, 9:16, 21:9, custom
metadata1.put("crop_strategy", "crop-center"); // fit, crop-center, crop-top, etc.
metadata1.put("quality", 85);                 // 1-100 (for JPG, WebP, AVIF)

ConversionResult result1 = client.convertFile(
    ConversionOptions.builder()
        .inputPath("./photo.jpg")
        .targetFormat("webp")
        .conversionMetadata(metadata1)
        .build()
);

// Example 2: Create square image for Instagram
Map<String, Object> metadata2 = new HashMap<>();
metadata2.put("aspect_ratio", "1:1");
metadata2.put("crop_strategy", "crop-center");
metadata2.put("quality", 90);

ConversionResult result2 = client.convertFile(
    ConversionOptions.builder()
        .inputPath("./photo.jpg")
        .targetFormat("jpg")
        .conversionMetadata(metadata2)
        .build()
);

// Example 3: Create ICO favicon
Map<String, Object> metadata3 = new HashMap<>();
metadata3.put("icon_size", 32);              // 16, 32, 48, 64, 128, 256
metadata3.put("crop_strategy", "crop-center");

ConversionResult result3 = client.convertFile(
    ConversionOptions.builder()
        .inputPath("./logo.png")
        .targetFormat("ico")
        .conversionMetadata(metadata3)
        .build()
);

// Extract text from a receipt image
Map metadata = Map.of(
    "ocr_format", "txt",
    "ocr_instructions", "Extract receipt items and total"
);

ConversionResult result = client.convertFile(
    ConversionOptions.builder()
        .inputPath("./receipt.jpg")
        .targetFormat("ocr")
        .outputPath("./receipt.txt")
        .conversionMetadata(metadata)
        .build()
);

System.out.println("Tokens used: " + result.getTokensUsed());
System.out.println("Extracted text saved to: " + result.getOutputPath());

gem install convertorio-sdk

gem 'convertorio-sdk', '~> 1.2'

require 'convertorio'

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

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

puts "Conversion completed: #{result[:job_id]}"

client.on(:progress) do |data|
  puts "#{data[:step]}: #{data[:message]}"
end

client.on(:complete) do |data|
  puts "Done in #{data[:processing_time]}ms"
end

result = client.convert_file(
  input_path: './document.pdf',
  target_format: 'png'
)

# Example 1: Convert to 16:9 widescreen
result1 = client.convert_file(
  input_path: './photo.jpg',
  target_format: 'webp',
  conversion_metadata: {
    aspect_ratio: '16:9',        # 1:1, 4:3, 16:9, 9:16, 21:9, custom
    crop_strategy: 'crop-center', # fit, crop-center, crop-top, etc.
    quality: 85                   # 1-100 (for JPG, WebP, AVIF)
  }
)

# Example 2: Resize and optimize
result2 = client.convert_file(
  input_path: './large-photo.png',
  target_format: 'jpg',
  conversion_metadata: {
    resize_width: 1920,  # Target width in pixels
    quality: 90
  }
)

# Example 3: Create ICO favicon
result3 = client.convert_file(
  input_path: './logo.png',
  target_format: 'ico',
  conversion_metadata: {
    icon_size: 32,              # 16, 32, 48, 64, 128, 256
    crop_strategy: 'crop-center'
  }
)

# Extract text from a form image
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]}"
puts "Extracted text saved to: #{result[:output_path]}"

dotnet add package Convertorio.SDK

Install-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}");
}

using (var client = new ConvertorioClient("your_api_key_here"))
{
    // Subscribe to events
    client.ConversionStart += (sender, e) =>
        Console.WriteLine($"Starting: {e.JobId}");

    client.ConversionProgress += (sender, e) =>
        Console.WriteLine($"{e.Step}: {e.Message}");

    client.ConversionStatus += (sender, e) =>
        Console.WriteLine($"Status: {e.Status}");

    client.ConversionComplete += (sender, e) =>
        Console.WriteLine($"Done in {e.ProcessingTime}ms");

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

// Example 1: Convert to 16:9 widescreen
var result1 = await client.ConvertFileAsync(new ConversionOptions
{
    InputPath = "./photo.jpg",
    TargetFormat = "webp",
    ConversionMetadata = new ConversionMetadata
    {
        AspectRatio = "16:9",        // 1:1, 4:3, 16:9, 9:16, 21:9, custom
        CropStrategy = "crop-center" // fit, crop-center, crop-top, etc.
    }
});

// Example 2: Convert to square with specific quality
var result2 = await client.ConvertFileAsync(new ConversionOptions
{
    InputPath = "./photo.jpg",
    TargetFormat = "jpg",
    ConversionMetadata = new ConversionMetadata
    {
        AspectRatio = "1:1",
        CropStrategy = "crop-center",
        Quality = 85
    }
});

// Example 3: Create an ICO file with multiple sizes
var result3 = await client.ConvertFileAsync(new ConversionOptions
{
    InputPath = "./logo.png",
    TargetFormat = "ico",
    ConversionMetadata = new ConversionMetadata
    {
        IconSizes = new[] { 16, 32, 48, 64 }
    }
});

// Extract text from an invoice image
using (var client = new ConvertorioClient(apiKey))
{
    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}");
    Console.WriteLine($"Extracted text saved to: {result.OutputPath}");
}

Authorization: Bearer cv_your_api_key_here

const apiKey = 'cv_your_api_key_here';
const baseUrl = 'https://api.convertorio.com/v1';

// Step 1: Request upload URL
const uploadResponse = await fetch(`${baseUrl}/convert/upload-url`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    filename: 'image.jpg',
    source_format: 'jpg',
    target_format: 'png',
    file_size: file.size
  })
});

const { job_id, upload_url } = await uploadResponse.json();

// Step 2: Upload file to S3
await fetch(upload_url, {
  method: 'PUT',
  body: file
});

// Step 3: Confirm upload
await fetch(`${baseUrl}/convert/confirm`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ job_id })
});

// Step 4: Poll for completion
const pollStatus = async () => {
  const statusResponse = await fetch(`${baseUrl}/jobs/${job_id}`, {
    headers: { 'Authorization': `Bearer ${apiKey}` }
  });
  const { job } = await statusResponse.json();

  if (job.status === 'completed') {
    console.log('Download URL:', job.download_url);
    return job.download_url;
  } else if (job.status === 'failed') {
    throw new Error(job.error_message);
  }

  // Poll again in 2 seconds
  await new Promise(r => setTimeout(r, 2000));
  return pollStatus();
};

const downloadUrl = await pollStatus();

{
  "filename": "image.jpg",
  "source_format": "jpg",
  "target_format": "png",
  "file_size": 1048576,
  "conversion_metadata": {
    "aspect_ratio": "16:9",
    "crop_strategy": "crop-center",
    "quality": 85,
    "icon_size": 32
  }
}

{
  "filename": "document.jpg",
  "source_format": "jpg",
  "target_format": "ocr",
  "file_size": 2048576,
  "conversion_metadata": {
    "ocr_format": "json",
    "ocr_instructions": "Extract all text and preserve formatting. Identify tables if present."
  }
}

{
  "success": true,
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "upload_url": "https://s3.amazonaws.com/...",
  "expires_in": 600
}

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000"
}

{
  "success": true,
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "message": "Job queued for processing"
}

{
  "success": true,
  "job": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "completed",
    "original_filename": "image.jpg",
    "source_format": "jpg",
    "target_format": "png",
    "file_size": 1048576,
    "points_cost": 1,
    "points_used": 1,
    "tokens_used": 0,
    "processing_time_ms": 1234,
    "created_at": "2025-01-19T10:00:00Z",
    "completed_at": "2025-01-19T10:00:02Z",
    "download_url": "https://s3.amazonaws.com/...",
    "can_download": true,
    "is_expired": false
  }
}

{
  "success": true,
  "job": {
    "id": "650e8400-e29b-41d4-a716-446655440001",
    "status": "completed",
    "original_filename": "invoice.jpg",
    "source_format": "jpg",
    "target_format": "ocr",
    "file_size": 1845120,
    "points_cost": 1,
    "points_used": 1,
    "tokens_used": 1247,
    "processing_time_ms": 3456,
    "created_at": "2025-01-19T14:30:00Z",
    "completed_at": "2025-01-19T14:30:03Z",
    "download_url": "https://s3.amazonaws.com/.../output.json",
    "can_download": true,
    "is_expired": false
  }
}

{
  "success": true,
  "jobs": [...],
  "count": 10,
  "pagination": {
    "limit": 50,
    "offset": 0
  }
}

{
  "success": true,
  "account": {
    "id": "user-id",
    "email": "user@example.com",
    "name": "John Doe",
    "plan": "free",
    "points": 100,
    "daily_conversions_remaining": 3,
    "total_conversions": 47
  }
}

POST /v1/convert/upload-url

{
  "filename": "document.jpg",
  "source_format": "jpg",
  "target_format": "ocr",
  "file_size": 2048576
}

{
  "filename": "invoice.jpg",
  "source_format": "jpg",
  "target_format": "ocr",
  "file_size": 2048576,
  "conversion_metadata": {
    "ocr_format": "json",
    "ocr_instructions": "Extract all text and identify invoice items in a table. Include date, total, and line items."
  }
}

{
  "success": true,
  "job": {
    "id": "650e8400-e29b-41d4-a716-446655440001",
    "status": "completed",
    "original_filename": "invoice.jpg",
    "source_format": "jpg",
    "target_format": "ocr",
    "points_used": 1,
    "tokens_used": 1247,
    "processing_time_ms": 3456,
    "download_url": "https://s3.amazonaws.com/.../output.json"
  }
}

const Convertorio = require('convertorio-sdk');
const client = new Convertorio('your-api-key');

// Basic OCR
const result = await client.convertFile({
    inputPath: './receipt.jpg',
    targetFormat: 'ocr',
    outputPath: './receipt.txt'
});

console.log(`Tokens used: ${result.tokensUsed}`);

// Advanced OCR with JSON output
const invoice = 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 data saved to invoice.json`);
console.log(`Tokens used: ${invoice.tokensUsed}`);

from convertorio import Convertorio

client = Convertorio('your-api-key')

# Basic OCR
result = client.convert_file(
    input_path='./document.jpg',
    target_format='ocr',
    output_path='./document.txt'
)

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

# Advanced OCR with custom instructions
result = client.convert_file(
    input_path='./form.jpg',
    target_format='ocr',
    output_path='./form.json',
    conversion_metadata={
        'ocr_format': 'json',
        'ocr_instructions': 'Extract form fields and values as JSON'
    }
)

print(f'Extracted: {result["tokens_used"]} tokens')

# Step 1: Request upload URL for OCR
curl -X POST https://api.convertorio.com/v1/convert/upload-url \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "invoice.jpg",
    "source_format": "jpg",
    "target_format": "ocr",
    "file_size": 2048576,
    "conversion_metadata": {
      "ocr_format": "json",
      "ocr_instructions": "Extract invoice items and total"
    }
  }'

# Step 2: Upload file (returns job_id and upload_url)
curl -X PUT "UPLOAD_URL_FROM_STEP_1" \
  --upload-file invoice.jpg

# Step 3: Confirm upload
curl -X POST https://api.convertorio.com/v1/convert/confirm \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_id": "JOB_ID_FROM_STEP_1"}'

# Step 4: Check status (poll until completed)
curl https://api.convertorio.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

# Response includes tokens_used field
# Download extracted text from download_url

{
  "success": false,
  "error": "Error message description"
}

import requests
import time

API_KEY = 'cv_your_api_key_here'
BASE_URL = 'https://api.convertorio.com/v1'

def convert_image(file_path, source_format, target_format):
    # Step 1: Request upload URL
    with open(file_path, 'rb') as f:
        file_size = len(f.read())

    response = requests.post(
        f'{BASE_URL}/convert/upload-url',
        headers={'Authorization': f'Bearer {API_KEY}'},
        json={
            'filename': file_path.split('/')[-1],
            'source_format': source_format,
            'target_format': target_format,
            'file_size': file_size
        }
    )
    data = response.json()
    job_id = data['job_id']
    upload_url = data['upload_url']

    # Step 2: Upload file
    with open(file_path, 'rb') as f:
        requests.put(upload_url, data=f)

    # Step 3: Confirm upload
    requests.post(
        f'{BASE_URL}/convert/confirm',
        headers={'Authorization': f'Bearer {API_KEY}'},
        json={'job_id': job_id}
    )

    # Step 4: Poll for completion
    while True:
        response = requests.get(
            f'{BASE_URL}/jobs/{job_id}',
            headers={'Authorization': f'Bearer {API_KEY}'}
        )
        job = response.json()['job']

        if job['status'] == 'completed':
            return job['download_url']
        elif job['status'] == 'failed':
            raise Exception(job['error_message'])

        time.sleep(2)

# Usage
download_url = convert_image('image.jpg', 'jpg', 'png')
print(f'Download URL: {download_url}')

const fs = require('fs');
const axios = require('axios');

const API_KEY = 'cv_your_api_key_here';
const BASE_URL = 'https://api.convertorio.com/v1';

async function convertImage(filePath, sourceFormat, targetFormat) {
  // Step 1: Request upload URL
  const fileBuffer = fs.readFileSync(filePath);
  const filename = filePath.split('/').pop();

  const uploadResponse = await axios.post(
    `${BASE_URL}/convert/upload-url`,
    {
      filename,
      source_format: sourceFormat,
      target_format: targetFormat,
      file_size: fileBuffer.length
    },
    { headers: { 'Authorization': `Bearer ${API_KEY}` }}
  );

  const { job_id, upload_url } = uploadResponse.data;

  // Step 2: Upload file
  await axios.put(upload_url, fileBuffer);

  // Step 3: Confirm upload
  await axios.post(
    `${BASE_URL}/convert/confirm`,
    { job_id },
    { headers: { 'Authorization': `Bearer ${API_KEY}` }}
  );

  // Step 4: Poll for completion
  while (true) {
    const statusResponse = await axios.get(
      `${BASE_URL}/jobs/${job_id}`,
      { headers: { 'Authorization': `Bearer ${API_KEY}` }}
    );

    const { job } = statusResponse.data;

    if (job.status === 'completed') {
      return job.download_url;
    } else if (job.status === 'failed') {
      throw new Error(job.error_message);
    }

    await new Promise(resolve => setTimeout(resolve, 2000));
  }
}

// Usage
convertImage('image.jpg', 'jpg', 'png')
  .then(url => console.log('Download URL:', url))
  .catch(err => console.error('Error:', err));

# Step 1: Request upload URL
curl -X POST https://api.convertorio.com/v1/convert/upload-url \
  -H "Authorization: Bearer cv_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "filename": "image.jpg",
    "source_format": "jpg",
    "target_format": "png",
    "file_size": 1048576
  }'

# Step 2: Upload file (replace UPLOAD_URL with response from step 1)
curl -X PUT "UPLOAD_URL" \
  --data-binary @image.jpg

# Step 3: Confirm upload (replace JOB_ID with response from step 1)
curl -X POST https://api.convertorio.com/v1/convert/confirm \
  -H "Authorization: Bearer cv_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"job_id": "JOB_ID"}'

# Step 4: Check status
curl https://api.convertorio.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer cv_your_api_key_here"