Aller au contenu principal
TransConvert

Video Conversion API

Convert video between MP4, MOV, AVI, MKV, and WEBM. Video encodes can take minutes, so this is an async, submit-then-poll endpoint rather than one blocking request — same ffmpeg engine behind TransConvert's website converter.

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

POST https://transconvert.com/api/v1/convert-async.php
Field Description
AuthorizationRequired. "Bearer tc_live_...".
categorySet to "video".
targetRequired. Output format code: "MP4", "MOV", "AVI", "MKV", or "WEBM".
fileRequired. The video file.
TransConvert
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" \
  -o output.mp4

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.

GET https://transconvert.com/api/v1/job-status.php?job_id=job_...
cURL
curl -H "Authorization: Bearer tc_live_your_key_here" \
  https://transconvert.com/api/v1/job-status.php?job_id=job_...

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.

Erreurs

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").

Status & code When it happens
401 missing_keyAucun en-tête Authorization n’a été envoyé.
401 invalid_keyLa clé n’existe pas, ou a été révoquée.
403 account_suspendedLe compte propriétaire de cette clé est suspendu.
403 plan_requiredLe compte est sur l’offre Free — l’accès à l’API nécessite Basic, Lite, Pro ou Team.
400 invalid_category"category" n’était pas "image" ni "document".
400 invalid_target« target » n’est pas un format de sortie pris en charge pour cette catégorie.
400 no_fileAucun fichier n’a été envoyé, ou l’envoi a échoué — le champ doit s’appeler "file".
413 file_too_largeLe fichier dépasse la taille maximale de téléversement autorisée par votre offre.
429 quota_exceededLe quota mensuel de minutes de conversion de l’offre est épuisé. Réinitialisation au début du mois calendaire suivant.
429 concurrency_limitTrop de conversions déjà en cours simultanément pour ce compte (partagé avec le site) — attendez qu’une conversion se termine, puis réessayez.
404 job_not_foundAucune tâche avec cet identifiant n’existe pour ce compte (également renvoyé pour le job_id d’un autre compte — son existence n’est jamais révélée).
410 result_goneLa tâche est terminée, mais son résultat a depuis été supprimé (les résultats sont supprimés immédiatement après le téléchargement, ou automatiquement après une courte période de conservation).
400/415/422/500/503 conversion_failedLe fichier lui-même n’a pas pu être converti — "message" en explique la raison. Le code de statut varie selon la cause : 400/415/422 signifient que le fichier ou la cible ne fonctionneront pas, peu importe le nombre de tentatives ; 500/503 signifient un problème côté serveur, et 503 en particulier mérite une brève nouvelle tentative.

Supported formats

MP4, MOV, AVI, MKV, WEBM

Voir aussi