Vai al contenuto principale
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.

Le conversioni video e audio possono richiedere diversi minuti, troppo a lungo per mantenere aperta una singola richiesta sincrona — per questo usano un flusso di invio e polling invece dell’endpoint qui sopra. Invia un file, ricevi subito un job_id, poi interroga lo stato finché non è completato.

Invia un job

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

Interroga lo stato

Interroga questo endpoint ogni pochi secondi con il job_id ricevuto. «status» può essere queued, processing, completed o 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_...

Scarica il risultato

Quando lo stato è «completed», la risposta include un download_url — lo stesso URL di stato con &download=1 aggiunto. Richiamandolo si ottiene lo streaming dei byte grezzi del file convertito, con le stesse intestazioni di ogni altro endpoint di questa pagina. Il risultato viene eliminato nel momento in cui viene scaricato, oppure automaticamente dopo un breve periodo di conservazione se non viene mai scaricato.

scheduleI risultati dei job vengono eliminati immediatamente dopo il download, oppure automaticamente dopo un breve periodo di conservazione se non vengono mai scaricati — scaricali tempestivamente.

Errori

Ogni errore restituisce un involucro JSON con un "code" su cui il tuo codice può ramificarsi, più un "message" leggibile. Alcuni errori includono campi aggiuntivi (quota_exceeded include ad esempio "limit" e "used").

Status & code When it happens
401 missing_keyNon è stato inviato alcun header Authorization.
401 invalid_keyLa chiave non esiste, oppure è stata revocata.
403 account_suspendedL'account proprietario di questa chiave è sospeso.
403 plan_requiredL'account è sul piano Free — l'accesso API richiede Basic, Lite, Pro o Team.
400 invalid_category"category" non era "image" né "document".
400 invalid_target«target» non è un formato di output supportato per quella categoria.
400 no_fileNon è stato inviato alcun file, oppure l'upload è fallito — il campo deve chiamarsi "file".
413 file_too_largeIl file supera la dimensione massima di caricamento del tuo piano.
429 quota_exceededLa quota mensile di minuti di conversione del piano è esaurita. Si azzera all'inizio del mese solare successivo.
429 concurrency_limitTroppe conversioni già in corso contemporaneamente per questo account (condiviso con il sito) — attendi che una finisca e riprova.
404 job_not_foundNon esiste alcun job con questo id per questo account (restituito anche per il job_id di un altro account — la sua esistenza non viene mai rivelata).
410 result_goneIl job è stato completato, ma il suo risultato è stato nel frattempo eliminato (i risultati vengono eliminati immediatamente dopo il download, oppure automaticamente dopo un breve periodo di conservazione).
400/415/422/500/503 conversion_failedIl file stesso non è stato convertibile — "message" spiega il motivo. Il codice di stato varia in base al motivo: 400/415/422 indicano che il file o il target non funzioneranno indipendentemente da quanti tentativi fai; 500/503 indicano un problema lato server, e in particolare il 503 vale la pena riprovarlo dopo poco.

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

Correlati