Zum Hauptinhalt springen
TransConvert

Audio Conversion API

Convert audio between any of 23 supported formats — MP3, WAV, OGG, AAC, FLAC, M4A, WMA, OPUS, AIFF, AMR, AU, CAF, AC3, DTS, GSM, IRCAM, MP2, TTA, VOC, W64, WV, SPX, and RM. Like video, this is an async, submit-then-poll endpoint rather than one blocking request — same ffmpeg engine behind TransConvert's website converter.

Video- und Audiokonvertierungen können mehrere Minuten dauern — zu lange, um eine einzelne synchrone Anfrage offen zu halten. Dafür wird statt des obigen Endpunkts ein Submit-dann-Poll-Ablauf verwendet: Sie senden eine Datei, erhalten sofort eine job_id zurück und fragen dann deren Status ab, bis der Vorgang abgeschlossen ist.

Auftrag einreichen

POST https://transconvert.com/api/v1/convert-async.php
Field Description
AuthorizationRequired. "Bearer tc_live_...".
categorySet to "audio".
targetRequired. Output format code: "MP3", "WAV", "OGG", "AAC", "FLAC", "M4A", "WMA", "OPUS", "AIFF", "AMR", "AU", "CAF", "AC3", "DTS", "GSM", "IRCAM", "MP2", "TTA", "VOC", "W64", "WV", "SPX", or "RM".
fileRequired. The audio file.
TransConvert
curl -X POST \
  https://transconvert.com/api/v1/convert-async.php \
  -H "Authorization: Bearer tc_live_your_key_here" \
  -F "category=audio" \
  -F "target=MP3" \
  -F "file=@track.wav" \
  -o output.mp3

Status abfragen

Fragen Sie diesen Endpunkt alle paar Sekunden mit der erhaltenen job_id ab. „status" ist einer von queued, processing, completed oder 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_...

Ergebnis herunterladen

Sobald der Status „completed" ist, enthält die Antwort eine download_url — dieselbe Status-URL mit angehängtem &download=1. Ruft man sie auf, werden die Rohdaten der konvertierten Datei gestreamt, mit denselben Headern wie bei jedem anderen Endpunkt auf dieser Seite. Das Ergebnis wird in dem Moment gelöscht, in dem es heruntergeladen wird, oder automatisch nach einem kurzen Aufbewahrungszeitraum, falls es nie heruntergeladen wird.

scheduleAuftragsergebnisse werden sofort nach dem Herunterladen gelöscht oder automatisch nach einem kurzen Aufbewahrungszeitraum, falls sie nie heruntergeladen werden — laden Sie sie zeitnah herunter.

Fehler

Jeder Fehler liefert einen JSON-Fehlerumschlag mit einem „code", anhand dessen Ihr Code Fallunterscheidungen treffen kann, sowie einer lesbaren „message". Manche Fehler enthalten zusätzliche Felder (quota_exceeded enthält beispielsweise „limit" und „used").

Status & code When it happens
401 missing_keyEs wurde kein Authorization-Header gesendet.
401 invalid_keyDer Schlüssel existiert nicht oder wurde widerrufen.
403 account_suspendedDas Konto, dem dieser Schlüssel gehört, ist gesperrt.
403 plan_requiredDas Konto nutzt den kostenlosen Plan – für API-Zugriff ist Basic, Lite, Pro oder Team erforderlich.
400 invalid_category„category" war weder „image" noch „document".
400 invalid_target„target" ist kein unterstütztes Ausgabeformat für diese Kategorie.
400 no_fileEs wurde keine Datei gesendet, oder der Upload ist fehlgeschlagen – das Feld muss „file" heißen.
413 file_too_largeDie Datei überschreitet die maximale Upload-Größe Ihres Plans.
429 quota_exceededDas monatliche Kontingent an Umwandlungsminuten des Plans ist aufgebraucht. Es wird zu Beginn des nächsten Kalendermonats zurückgesetzt.
429 concurrency_limitFür dieses Konto laufen bereits zu viele Konvertierungen gleichzeitig (gemeinsam mit der Website genutzt) – warten Sie, bis eine davon abgeschlossen ist, und versuchen Sie es erneut.
404 job_not_foundFür dieses Konto existiert kein Auftrag mit dieser ID (wird auch für die job_id eines anderen Kontos zurückgegeben — deren Existenz wird nie preisgegeben).
410 result_goneDer Auftrag wurde abgeschlossen, aber sein Ergebnis wurde inzwischen gelöscht (Ergebnisse werden sofort nach dem Herunterladen oder automatisch nach einem kurzen Aufbewahrungszeitraum entfernt).
400/415/422/500/503 conversion_failedDie Datei selbst konnte nicht konvertiert werden – „message" erklärt den Grund. Der Statuscode hängt vom Grund ab: 400/415/422 bedeuten, dass die Datei oder das Zielformat unabhängig von der Anzahl der Versuche nicht funktionieren wird; 500/503 bedeuten ein serverseitiges Problem, wobei sich bei 503 insbesondere ein kurzer erneuter Versuch lohnt.

Supported formats

MP3, WAV, OGG, AAC, FLAC, M4A, WMA, OPUS, AIFF, AMR, AU, CAF, AC3, DTS, GSM, IRCAM, MP2, TTA, VOC, W64, WV, SPX, RM

Weitere Themen