Thumbnail API

One API to handle them all. More than 200 formats supported.

API Documentation

Generate Thumbnails

CloudConvert is your Swiss army knife for file conversions. We support nearly all document, image and video formats. You can select input format from the dropdown above to check support.

Security

CloudConvert has been trusted by our users and customers since its founding in 2012. We are committed to maintaining an extensive security program that includes both technical and organizational security measures. Read more about that in our Security Overview.

High-Quality Conversions

Besides using open source software under the hood, we’ve partnered with various software vendors to provide the best possible results for all conversion types. Checkout our online converter and try it out with your own example files.

Advanced Options

Most conversion types can be adjusted to your needs such as setting the quality and many other options. We even do support adding watermarks to the output files. Check out the API documentation to show all available options, depending on the conversion type.

Async or Sync

By default, the CloudConvert API converts your files asynchronously and we notify you via webhooks when we are done. Depending on your needs there is also a synchronous API to convert files on-the-fly.

Storage Integration

CloudConvert directly fetches the input files from your object storage and then stores the output file at the same place. We are integrated with your existing and trusted storage provider, such as S3, Azure, Google Cloud or many others.

Custom Workflows

Our API uses the concept of Jobs and allows to do multiple operations with one single API call. For example, it is possible to convert the same file to multiple output formats, adding a watermark and creating a thumbnail with one single Job!

Developer Friendly

Our extensive API Documentation helps to get you started quickly. There is a Job Builder which generates ready-to-use request payloads and code snippets for you. We do provide free and timely support, directly from the builders of CloudConvert.

Raw Request PHP node.js Ruby Python Java .NET

POST https://sync.api.cloudconvert.com/v2/jobs
{
  "tasks": {
    "import-my-file": {
      "operation": "import/url",
      "url": "https://my.url/file.docx"
    },
    "convert-my-file": {
      "operation": "thumbnail",
      "input": "import-my-file",
      "output_format": "png",
      "width": 640,
      "height": 480,
      "fit": "crop"
    },
    "export-my-file": {
      "operation": "export/url",
      "input": "convert-my-file"
    }
  },
  "redirect": true
}
<?php
$job = (new Job())
    ->addTask(
        (new Task('import/url', 'import-my-file'))
            ->set('url', 'https://my.url/file.docx')
    )
    ->addTask(
        (new Task('thumbnail', 'convert-my-file'))
            ->set('input', 'import-my-file')
            ->set('output_format', 'png')
            ->set('width', 640)
            ->set('height', 480)
            ->set('fit', 'crop')
    )
    ->addTask(
        (new Task('export/url', 'export-my-file'))
            ->set('input', 'convert-my-file')
    );

$cloudconvert->jobs()->create($job);
let exampleJob = await cloudConvert.jobs.create({
    "tasks": {
        "import-my-file": {
            "operation": "import/url",
            "url": "https://my.url/file.docx"
        },
        "convert-my-file": {
            "operation": "thumbnail",
            "input": "import-my-file",
            "output_format": "png",
            "width": 640,
            "height": 480,
            "fit": "crop"
        },
        "export-my-file": {
            "operation": "export/url",
            "input": "convert-my-file"
        }
    }
});

job = await cloudConvert.jobs.wait(job.id);
job = cloudconvert.jobs.create({
  tasks: [
    {
      name: "import-my-file",
      operation: "import/url",
      url: "https://my-url/file.docx"
    },
    {
      name: "convert-my-file",
      operation: "thumbnail",
      input: "import-my-file",
      output_format: "png",
      width: 640,
      height: 480,
      fit: "crop"
    },
    {
      name: "export-my-file",
      operation: "export/url",
      input: "convert-my-file"
    },
  ]
})
job = cloudconvert.Job.create(payload={
     'tasks': {
         'import-my-file': {
              'operation': 'import/url',
              'url': 'https://my.url/file.docx'
         },
         'convert-my-file': {
             'operation': 'thumbnail',
             'input': 'import-my-file',
             'output_format': 'png',
             'width': 640,
             'height': 480,
             'fit': 'crop'
         },
         'export-my-file': {
             'operation': 'export/url',
             'input': 'convert-my-file'
         }
     }
 })
final JobResponse createJobResponse = cloudConvertClient.jobs().create(
    ImmutableMap.of(
        "import-my-file",
            new UrlImportRequest()
                .setUrl("https://my.url/file.docx"),
        "convert-my-file",
            new CreateThumbnailsTaskRequest()
                .setInput("import-my-file")
                .setOutputFormat("png"),
                .set('width', 640)
                .set('height', 480)
                .set('fit', 'crop')
        "export-my-file",
            new UrlExportRequest()
                .setInput("convert-my-file")
    )
).getBody();
var job = await CloudConvert.CreateJobAsync(new JobCreateRequest
      {
        Tasks = new
        {
          import_it = new ImportUrlCreateRequest
          {
            Url = "https://my.url/file.docx"
          },
          convert = new ThumbnailCreateRequest
          {
            Input = "import_it",
            Output_Format = "png"
            Width = 640,
            Height = 480,
            Fit = "Crop"
          },
          export_it = new ExportUrlCreateRequest
          {
            Input = "convert"
          }
        }
      });

Use our Job Builder to generate ready-to-use requests and code snippet for the CloudConvert API.

Job Builder API Documentation
On-demand, transparent pricing

Starting at 0.00 per file

When Converting Files

Corresponds to a one-timemonthly payment of . Checkout the full pricing information.