Pular para o conteúdo principal
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.

Conversões de vídeo e áudio podem levar minutos — tempo demais para manter uma única requisição síncrona aberta — então elas usam um fluxo de enviar-e-consultar em vez do endpoint acima. Envie um arquivo, receba um job_id na hora e consulte o status até terminar.

Enviar um 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

Consultar o status

Consulte este endpoint a cada poucos segundos com o job_id que você recebeu. "status" é um destes: 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_...

Baixar o resultado

Quando o status for "completed", a resposta inclui um download_url — a mesma URL de status com &download=1 adicionado. Ao requisitá-la, você recebe os bytes brutos do arquivo convertido, com os mesmos cabeçalhos de qualquer outro endpoint desta página. O resultado é excluído no momento em que é baixado, ou automaticamente após um curto período de retenção caso nunca seja baixado.

scheduleOs resultados dos jobs são excluídos imediatamente após o download, ou automaticamente após um curto período de retenção caso nunca sejam baixados — baixe assim que possível.

Erros

Toda falha retorna um envelope de erro JSON com um "code" no qual seu código pode se basear, além de uma "message" legível por humanos. Alguns erros incluem campos extras (quota_exceeded inclui "limit" e "used", por exemplo).

Status & code When it happens
401 missing_keyNenhum cabeçalho Authorization foi enviado.
401 invalid_keyA chave não existe, ou foi revogada.
403 account_suspendedA conta dona dessa chave está suspensa.
403 plan_requiredA conta está no plano Gratuito — o acesso à API exige Basic, Lite, Pro ou Equipe.
400 invalid_category"category" não era "image" nem "document".
400 invalid_target"target" não é um formato de saída compatível para essa categoria.
400 no_fileNenhum arquivo foi enviado, ou o upload falhou — o campo precisa se chamar "file".
413 file_too_largeO arquivo excede o tamanho máximo de upload do seu plano.
429 quota_exceededA cota mensal de minutos de conversão do plano já foi usada. Reinicia no começo do próximo mês do calendário.
429 concurrency_limitJá há conversões demais rodando ao mesmo tempo para essa conta (compartilhado com o site) — espere uma terminar e tente de novo.
404 job_not_foundNão existe nenhum job com esse id para esta conta (também retornado para o job_id de outra conta — sua existência nunca é revelada).
410 result_goneO job foi concluído, mas o resultado já foi excluído (os resultados são excluídos imediatamente após o download, ou automaticamente após um curto período de retenção).
400/415/422/500/503 conversion_failedO próprio arquivo não pôde ser convertido — "message" explica o motivo. O código de status varia conforme o motivo: 400/415/422 significam que o arquivo ou o target não vão funcionar não importa quantas vezes você tente de novo; 500/503 significam um problema do lado do servidor, e 503 especificamente vale a pena tentar de novo em pouco tempo.

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

Relacionados