TransConvert API

Van nul naar je eerste geconverteerde bestand in drie stappen.

Voor elk verzoek is een API-sleutel vereist, verzonden als Bearer-token in de Authorization-header.

Beschikbaar bij de abonnementen Basic, Lite, Pro en Team. Genereer een sleutel via je account →

Test je sleutel

Een snelle manier om te bevestigen dat een sleutel werkt voordat je echte integratiecode schrijft — dit converteert op zichzelf niets (er is geen bestand bijgevoegd), maar een 400 no_file in plaats van een 401 bevestigt dat de sleutel zelf geldig is.

Eén enkel endpoint verwerkt elke conversie. Stuur een multipart/form-data POST-verzoek met je bestand en de onderstaande velden.

Parameters

Veelgebruikte conversies

Een snel overzicht van populaire combinaties — hetzelfde endpoint verwerkt ze allemaal, alleen met een andere category/target-combinatie.

Respons

Bij succes (200): de ruwe bytes van het geconverteerde bestand, met bijbehorende Content-Type- en Content-Disposition-headers. Bij een fout: een JSON-body in de vorm {"error": {"code": "...", "message": "..."}} met een passende HTTP-statuscode — zie Fouten hieronder.

Verklein een bestand zonder het formaat te wijzigen — hetzelfde formaat erin, hetzelfde formaat eruit. Een apart paar categorieën naast conversie, image-compress en document-compress, elk met hun eigen opties hieronder.

image-compress

Hetzelfde formaat erin, hetzelfde formaat eruit (JPG/PNG/WEBP/GIF) — target_percent geeft aan hoe klein het resultaat ten opzichte van het origineel moet worden, geen vaste kwaliteitsinstelling.

curl -X POST \
  https://transconvert.com/api/v1/convert.php \
  -H "Authorization: Bearer tc_live_your_key_here" \
  -F "category=image-compress" \
  -F "target_percent=50" \
  -F "file=@photo.jpg" \
  -o compressed.jpg

document-compress

PDF erin, PDF eruit, via Ghostscripts eigen hercompressie — levert nooit een bestand op dat groter is dan het geüploade bestand (valt terug op het origineel als hercompressie niet hielp).

curl -X POST \
  https://transconvert.com/api/v1/convert.php \
  -H "Authorization: Bearer tc_live_your_key_here" \
  -F "category=document-compress" \
  -F "level=high" \
  -F "file=@report.pdf" \
  -o compressed.pdf

Video- en audioconversies kunnen minuten duren — te lang om één synchrone aanvraag open te houden. Deze gebruiken daarom een submit-then-poll-flow in plaats van het bovenstaande endpoint. Dien een bestand in, ontvang direct een job_id terug, en vraag daarna de status op totdat de conversie klaar is.

Een taak indienen

Dezelfde multipart POST-vorm als het hoofdendpoint, op een andere URL.

curl -X POST \
  https://transconvert.com/api/v1/convert-async.php \
  -H "Authorization: Bearer tc_live_your_key_here" \
  -F "category=video" \
  -F "target=MP4" \
  -F "file=@clip.mov"

Antwoord (202 Accepted)

{ "job_id": "job_242e1555d78d166807aa56502f15d118", "status": "queued" }

Status opvragen

Vraag dit elke paar seconden op met de job_id die je hebt teruggekregen. "status" is queued, processing, completed of failed.

{
  "job_id": "job_242e1555d78d166807aa56502f15d118",
  "status": "completed",
  "category": "video",
  "target_format": "MP4",
  "created_at": "2026-08-26 19:17:47",
  "download_url": "/api/v1/job-status.php?job_id=job_...&download=1",
  "filename": "clip.mp4"
}

Webhooks (optioneel)

Als u bij het indienen een webhook_url heeft opgegeven, posten we dezelfde JSON-body daar één keer heen zodra de job klaar is — succes of mislukking — met een paar nieuwe pogingen als uw endpoint niet reageert. job-status.php blijft sowieso als terugval werken.

POST your webhook_url
{
  "job_id": "job_242e1555d78d166807aa56502f15d118",
  "status": "completed",
  "category": "video",
  "target_format": "MP4",
  "created_at": "2026-08-26 19:17:47",
  "download_url": "https://transconvert.com/api/v1/job-status.php?job_id=job_...&download=1",
  "filename": "clip.mp4"
}

Het resultaat downloaden

Zodra de status "completed" is, bevat het antwoord een download_url — dezelfde status-URL met &download=1 toegevoegd. Deze opvragen stuurt vervolgens de ruwe bytes van het geconverteerde bestand, met dezelfde headers als elk ander endpoint op deze pagina. Het resultaat wordt verwijderd zodra het is gedownload, of automatisch na een korte bewaartermijn als het nooit wordt gedownload.

scheduleTaakresultaten worden direct na het downloaden verwijderd, of automatisch na een korte bewaartermijn als ze nooit worden gedownload — download ze op tijd.

Hetzelfde verzoek in vier talen — kies wat bij jouw stack past. Elk voorbeeld converteert een lokale photo.jpg naar PNG en slaat het resultaat op.

curl -X POST \
  https://transconvert.com/api/v1/convert.php \
  -H "Authorization: Bearer tc_live_your_key_here" \
  -F "category=image" \
  -F "target=PNG" \
  -F "file=@photo.jpg" \
  -o converted.png

<?php
$ch = curl_init('https://transconvert.com/api/v1/convert.php');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer tc_live_your_key_here'],
    CURLOPT_POSTFIELDS => [
        'category' => 'image',
        'target' => 'PNG',
        'file' => new CURLFile('photo.jpg'),
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($status === 200) {
    file_put_contents('converted.png', $response);
} else {
    $error = json_decode($response, true);
    echo $error['error']['message'];
}

const form = new FormData();
form.append('category', 'image');
form.append('target', 'PNG');
form.append('file', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');

const res = await fetch('https://transconvert.com/api/v1/convert.php', {
  method: 'POST',
  headers: { Authorization: 'Bearer tc_live_your_key_here' },
  body: form,
});

if (res.ok) {
  fs.writeFileSync('converted.png', Buffer.from(await res.arrayBuffer()));
} else {
  const { error } = await res.json();
  console.error(error.message);
}

import requests

with open('photo.jpg', 'rb') as f:
    response = requests.post(
        'https://transconvert.com/api/v1/convert.php',
        headers={'Authorization': 'Bearer tc_live_your_key_here'},
        data={'category': 'image', 'target': 'PNG'},
        files={'file': f},
    )

if response.status_code == 200:
    with open('converted.png', 'wb') as out:
        out.write(response.content)
else:
    print(response.json()['error']['message'])

# gem install multipart-post
require 'net/http'
require 'net/http/post/multipart'

url = URI('https://transconvert.com/api/v1/convert.php')

File.open('photo.jpg') do |file|
  req = Net::HTTP::Post::Multipart.new url,
    'category' => 'image',
    'target' => 'PNG',
    'file' => UploadIO.new(file, 'image/jpeg', 'photo.jpg')
  req['Authorization'] = 'Bearer tc_live_your_key_here'

  res = Net::HTTP.start(url.host, url.port, use_ssl: true) do |http|
    http.request(req)
  end

  if res.code == '200'
    File.write('converted.png', res.body)
  else
    puts JSON.parse(res.body)['error']['message']
  end
end

// Gradle: implementation("com.squareup.okhttp3:okhttp:4.+")
OkHttpClient client = new OkHttpClient();

RequestBody body = new MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("category", "image")
    .addFormDataPart("target", "PNG")
    .addFormDataPart("file", "photo.jpg",
        RequestBody.create(new File("photo.jpg"), MediaType.parse("image/jpeg")))
    .build();

Request request = new Request.Builder()
    .url("https://transconvert.com/api/v1/convert.php")
    .header("Authorization", "Bearer tc_live_your_key_here")
    .post(body)
    .build();

try (Response response = client.newCall(request).execute()) {
    if (response.isSuccessful()) {
        Files.write(Paths.get("converted.png"), response.body().bytes());
    } else {
        System.err.println(response.body().string());
    }
}

Elke fout retourneert een JSON-foutobject met een "code" waarop je code kan vertakken, plus een leesbaar "message". Sommige fouten bevatten extra velden (quota_exceeded bevat bijvoorbeeld "limit" en "used").

{
  "error": {
    "code": "quota_exceeded",
    "message": "Monthly API allowance of 5000 conversion-minutes reached.",
    "limit": 5000,
    "used": 5000
  }
}

Fouten afhandelen & opnieuw proberen

Vertak op basis van het JSON-veld "code", niet op de tekst van "message" — de formulering kan in de loop van de tijd veranderen, de code niet. Bij concurrency_limit is een korte nieuwe poging na een paar seconden de moeite waard (deze fout verdwijnt zodra een van je lopende conversies klaar is); quota_exceeded lost zichzelf pas volgende maand op, probeer het dus niet in een lus opnieuw. conversion_failed is de enige code waarbij de HTTP-status nog steeds van belang is: een 503 is een tijdelijk serverprobleem waarbij één korte nieuwe poging de moeite waard is, terwijl 400/415/422/500 betekenen dat exact die bestand/target-combinatie nooit zal slagen, hoe vaak je het ook opnieuw verstuurt. Door de bestandsgrootte vooraf aan de clientzijde te controleren, voorkom je dat je een verzoek verspilt aan een gegarandeerde file_too_large.

De API deelt zijn limieten met hetzelfde abonnement dat je al op de website gebruikt — er is niets apart in te stellen.

Zodra een limiet per minuut geldt, bevat elk antwoord de headers X-RateLimit-Limit en X-RateLimit-Remaining; een 429-antwoord bevat ook Retry-After (in seconden) — gebruik deze om af te remmen voordat u de limiet bereikt, in plaats van pas te reageren na een 429.

Exact dezelfde conversie-engine als die de website gebruikt — niets is exclusief voor de API of exclusief voor de website.

infoVideo en audio — zowel converteren als comprimeren — zijn voorlopig alleen op de website beschikbaar: een synchrone HTTP-aanroep is niet geschikt voor een taak die enkele minuten kan duren.