Direct naar de inhoud
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.

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

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

Status opvragen

Vraag dit elke paar seconden op met de job_id die je hebt teruggekregen. "status" is queued, processing, completed of 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_...

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.

Fouten

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

Status & code When it happens
401 missing_keyEr is geen Authorization-header meegestuurd.
401 invalid_keyDe sleutel bestaat niet, of is ingetrokken.
403 account_suspendedHet account waartoe deze sleutel behoort, is geschorst.
403 plan_requiredHet account heeft het gratis abonnement — voor API-toegang is Basic, Lite, Pro of Team vereist.
400 invalid_category"category" was niet "image" of "document".
400 invalid_target"target" is geen ondersteund uitvoerformaat voor die categorie.
400 no_fileEr is geen bestand verzonden, of de upload is mislukt — het veld moet "file" heten.
413 file_too_largeHet bestand overschrijdt de maximale uploadgrootte van je abonnement.
429 quota_exceededDe maandelijkse toewijzing conversieminuten van het abonnement is op. Wordt gereset aan het begin van de volgende kalendermaand.
429 concurrency_limitEr lopen al te veel conversies tegelijk voor dit account (gedeeld met de website) — wacht tot er één klaar is en probeer het opnieuw.
404 job_not_foundEr bestaat geen taak met dat id voor dit account (dit antwoord wordt ook gegeven voor de job_id van een ander account — het bestaan ervan wordt nooit onthuld).
410 result_goneDe taak is voltooid, maar het resultaat is inmiddels verwijderd (resultaten worden direct na het downloaden verwijderd, of automatisch na een korte bewaartermijn).
400/415/422/500/503 conversion_failedHet bestand zelf kon niet worden geconverteerd — "message" legt uit waarom. De statuscode varieert met de reden: 400/415/422 betekenen dat het bestand of target nooit zal werken, hoe vaak je het ook probeert; 500/503 duiden op een probleem aan de serverkant, en bij 503 is een korte nieuwe poging de moeite waard.

Supported formats

MP4, MOV, AVI, MKV, WEBM

Gerelateerd