API TransConvert

De zéro à votre premier fichier converti en trois étapes.

Chaque requête nécessite une clé API, envoyée comme jeton Bearer dans l’en-tête Authorization.

Disponible avec les offres Basic, Lite, Pro et Team. Générez une clé depuis votre compte →

Testez votre clé

Un moyen rapide de vérifier qu’une clé fonctionne avant d’écrire du code d’intégration réel — ceci seul ne convertira rien (aucun fichier joint), mais un 400 no_file plutôt qu’un 401 confirme que la clé elle-même est valide.

Un seul point de terminaison gère toutes les conversions. Envoyez une requête POST multipart/form-data avec votre fichier et les champs ci-dessous.

Paramètres

Conversions courantes

Une référence rapide pour les paires les plus courantes — le même point de terminaison les gère toutes, avec simplement une combinaison category/target différente.

Réponse

En cas de succès (200) : les octets bruts du fichier converti, avec les en-têtes Content-Type et Content-Disposition renseignés en conséquence. En cas d’échec : un corps JSON de la forme {"error": {"code": "...", "message": "..."}} avec un code de statut HTTP correspondant — voir Erreurs ci-dessous.

Réduisez la taille d’un fichier sans en changer le format — même format en entrée, même format en sortie. Une paire de catégories distincte de la conversion, image-compress et document-compress, chacune avec ses propres options ci-dessous.

image-compress

Même format en entrée, même format en sortie (JPG/PNG/WEBP/GIF) — target_percent indique la taille visée du résultat par rapport à l’original, ce n’est pas un réglage de qualité fixe.

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 en entrée, PDF en sortie, via la recompression propre à Ghostscript — ne renvoie jamais un fichier plus volumineux que celui envoyé (l’original est renvoyé tel quel si la recompression n’a pas aidé).

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

Les conversions vidéo et audio peuvent durer plusieurs minutes, trop longtemps pour maintenir ouverte une seule requête synchrone — celles-ci utilisent donc un flux d’envoi puis d’interrogation plutôt que le point de terminaison ci-dessus. Envoyez un fichier, récupérez immédiatement un job_id, puis interrogez son statut jusqu’à ce qu’il soit terminé.

Envoyer une tâche

Même structure de requête POST multipart que le point de terminaison principal, mais à une URL différente.

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"

Réponse (202 Accepted)

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

Interroger le statut

Interrogez cette adresse toutes les quelques secondes avec le job_id récupéré précédemment. « status » vaut queued, processing, completed ou 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 (facultatif)

Si vous avez fourni un webhook_url lors de l'envoi, nous POSTerons ce même corps JSON une fois le job terminé — succès ou échec — en réessayant quelques fois si votre point de terminaison ne répond pas. job-status.php reste disponible comme solution de repli.

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"
}

Télécharger le résultat

Une fois le statut « completed », la réponse contient un download_url — la même URL de statut avec &download=1 ajouté. Sa requête renvoie alors les octets bruts du fichier converti, avec les mêmes en-têtes que tout autre point de terminaison de cette page. Le résultat est supprimé dès qu'il est téléchargé, ou automatiquement après une courte période de conservation s'il n'est jamais téléchargé.

scheduleLes résultats des tâches sont supprimés immédiatement après le téléchargement, ou automatiquement après une courte période de conservation s'ils ne sont jamais téléchargés — téléchargez-les rapidement.

La même requête dans quatre langages — choisissez celui qui correspond à votre stack. Chacun convertit un fichier local photo.jpg en PNG et enregistre le résultat.

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());
    }
}

Chaque échec renvoie une enveloppe d’erreur JSON avec un "code" que votre application peut tester, ainsi qu’un "message" lisible. Certaines erreurs incluent des champs supplémentaires (quota_exceeded inclut par exemple "limit" et "used").

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

Gérer les erreurs et les nouvelles tentatives

Basez votre logique sur le champ JSON "code", pas sur le texte de "message" — le texte peut changer, le code non. concurrency_limit mérite une brève nouvelle tentative après quelques secondes (elle se résout dès qu’une de vos conversions en cours se termine) ; quota_exceeded ne se résoudra pas avant le mois prochain, donc ne le retentez pas en boucle. conversion_failed est le seul code où le statut HTTP compte encore : un 503 est un problème serveur temporaire qui mérite une brève nouvelle tentative, tandis que 400/415/422/500 signifient que cette combinaison précise de fichier/cible ne réussira jamais, quel que soit le nombre de tentatives. Vérifier la taille d’un fichier côté client avant l’envoi évite de gaspiller une requête pour un file_too_large garanti.

L’API partage ses limites avec l’offre que vous utilisez déjà sur le site — rien à configurer séparément.

Dès qu’une limite par minute s’applique, chaque réponse inclut les en-têtes X-RateLimit-Limit et X-RateLimit-Remaining ; une réponse 429 inclut aussi Retry-After (en secondes) — utilisez-les pour ralentir avant d’atteindre la limite plutôt que de réagir seulement après un 429.

Exactement le même moteur de conversion que celui utilisé par le site — rien n’est exclusif à l’API ou au site.

infoLa vidéo et l’audio — conversion comme compression — restent pour l’instant réservés au site : un appel HTTP synchrone se prête mal à une tâche pouvant durer plusieurs minutes.