跳转到主要内容
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.

视频和音频转换可能需要数分钟才能完成,时间太长,无法用单次同步请求处理——因此这类转换使用“先提交、后轮询”的流程,而不是上方的接口。提交文件后会立即获得一个 job_id,随后轮询其状态直至完成。

提交任务

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

轮询状态

使用返回的 job_id 每隔几秒轮询一次此接口。"status" 的取值为 queued、processing、completed 或 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_...

下载结果

当 status 变为 "completed" 后,响应中会包含 download_url——即在同一个状态查询 URL 后附加 &download=1。请求该地址会以原始字节流返回转换后的文件,响应头与本页其他接口一致。结果会在被下载的那一刻立即删除;如果从未被下载,则会在短暂的保留期后自动删除。

schedule任务结果会在下载后立即删除;如果从未被下载,则会在短暂的保留期后自动删除——请及时下载。

错误

每个失败请求都会返回一个 JSON 错误信息,其中包含可供代码判断分支的 "code",以及便于阅读的 "message"。部分错误还包含额外字段(例如 quota_exceeded 会包含 "limit" 和 "used")。

Status & code When it happens
401 missing_key未发送 Authorization 请求头。
401 invalid_key密钥不存在,或已被撤销。
403 account_suspended拥有此密钥的账户已被暂停。
403 plan_required该账户为 Free 套餐——API 访问权限需要 Basic、Lite、Pro 或 Team 套餐。
400 invalid_category"category" 既不是 "image" 也不是 "document"。
400 invalid_target"target" 不是该类别支持的输出格式。
400 no_file未发送文件,或上传失败——字段名必须为 "file"。
413 file_too_large文件大小超出您所在套餐的最大上传限制。
429 quota_exceeded该套餐每月的转换分钟数已用完,将于下个自然月初重置。
429 concurrency_limit此账户同时运行的转换任务过多(与网站共用限额)——请等待其中一个完成后重试。
404 job_not_found该账户下不存在此 id 对应的任务(对其他账户的 job_id 同样会返回此错误——不会泄露其是否存在)。
410 result_gone任务已完成,但其结果已被删除(结果会在下载后立即删除,或在从未下载的情况下于短暂保留期后自动删除)。
400/415/422/500/503 conversion_failed文件本身无法转换——"message" 中会说明原因。状态码会因原因而异:400/415/422 表示无论重试多少次,该文件或目标格式都无法成功;500/503 表示服务器端出现问题,其中 503 值得进行一次短暂重试。

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

相关内容