Saltar al contenido 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.

Las conversiones de vídeo y audio pueden tardar minutos, demasiado tiempo para mantener abierta una única solicitud síncrona — estas usan un flujo de envío y consulta en lugar del endpoint anterior. Envía un archivo, recibe enseguida un job_id y luego consulta su estado hasta que termine.

Enviar un trabajo

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 el estado

Consulta esto cada pocos segundos con el job_id que recibiste. «status» es uno de 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_...

Descargar el resultado

Cuando el estado sea «completed», la respuesta incluye una download_url — la misma URL de estado con &download=1 añadido. Solicitarla transmite entonces los bytes en bruto del archivo convertido, con las mismas cabeceras que cualquier otro endpoint de esta página. El resultado se elimina en el momento en que se descarga, o automáticamente tras un breve período de conservación si nunca se descarga.

scheduleLos resultados de los trabajos se eliminan inmediatamente después de la descarga, o automáticamente tras un breve período de conservación si nunca se descargan — descárgalos cuanto antes.

Errores

Cada error devuelve un JSON con un "code" sobre el que tu código puede ramificarse, además de un "message" legible por humanos. Algunos errores incluyen campos adicionales (quota_exceeded incluye, por ejemplo, "limit" y "used").

Status & code When it happens
401 missing_keyNo se envió ninguna cabecera Authorization.
401 invalid_keyLa clave no existe, o ha sido revocada.
403 account_suspendedLa cuenta propietaria de esta clave está suspendida.
403 plan_requiredLa cuenta está en el plan Free: el acceso a la API requiere Basic, Lite, Pro o Team.
400 invalid_category"category" no era "image" ni "document".
400 invalid_target«target» no es un formato de salida compatible para esa categoría.
400 no_fileNo se envió ningún archivo, o la subida falló; el campo debe llamarse "file".
413 file_too_largeEl archivo supera el tamaño máximo de subida permitido por tu plan.
429 quota_exceededSe agotó la asignación mensual de minutos de conversión del plan. Se restablece al inicio del siguiente mes natural.
429 concurrency_limitYa hay demasiadas conversiones en curso a la vez para esta cuenta (se comparte con el sitio web); espera a que termine una y vuelve a intentarlo.
404 job_not_foundNo existe ningún trabajo con ese id para esta cuenta (también se devuelve para el job_id de otra cuenta — su existencia nunca se revela).
410 result_goneEl trabajo se completó, pero su resultado ya se ha eliminado (los resultados se eliminan inmediatamente después de la descarga, o automáticamente tras un breve período de conservación).
400/415/422/500/503 conversion_failedEl propio archivo no se pudo convertir; "message" explica el motivo. El código de estado varía según la causa: 400/415/422 significan que el archivo o el destino no funcionarán por más intentos que hagas; 500/503 indican un problema del lado del servidor, y en concreto 503 merece un breve reintento.

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

Relacionado