API Doc

音频格式转换

上传一个音频文件，按指定目标格式输出新的可下载文件。

路径： /api/audio-convert.php 方法： POST 类型： multipart/form-data 认证： 无需鉴权

请求参数在线调试返回结果调用示例错误说明

请求参数

参数名	必填	类型	说明
`audio`	是	File	待转换的音频文件，单文件上限 500MB。
`output_format`	是	string	`mp3`、`wav`、`m4a`、`aac`、`flac`、`ogg`、`opus`、`wma`
`audio_bitrate`	否	string	`high`、`medium`、`low`，默认 `medium`。无损格式可不传。
`sample_rate`	否	string	`original`、`48000`、`44100`、`32000`、`22050`，默认 `original`。

在线调试

直接在当前页面提交测试请求。

音频文件

output_format

audio_bitrate

sample_rate

请求地址

调试结果

成功返回

{
  "code": 0,
  "msg": "转换成功",
  "data": {
    "download_url": "https://api.jiexin.name/storage/outputs/demo-7f3c9f3b.mp3",
    "download_name": "demo-converted.mp3",
    "format_text": "MP3",
    "source_size_text": "8.42 MB",
    "size_text": "3.18 MB",
    "change_text": "体积减小 62.2%"
  }
}

调用示例

cURL

curl --request POST "https://api.jiexin.name/api/audio-convert.php" \
  --form "audio=@/path/to/demo.wav" \
  --form "output_format=mp3" \
  --form "audio_bitrate=medium" \
  --form "sample_rate=44100"

JavaScript

const formData = new FormData();
formData.append("audio", fileInput.files[0]);
formData.append("output_format", "mp3");
formData.append("audio_bitrate", "medium");
formData.append("sample_rate", "44100");

const response = await fetch("https://api.jiexin.name/api/audio-convert.php", {
  method: "POST",
  body: formData
});

const result = await response.json();
console.log(result);

错误说明

HTTP 状态	msg	说明
405	仅支持 POST 请求	请求方法错误。
422	未接收到上传文件 / 文件过大 / 输出格式无效	请求参数或上传文件不符合要求。
500	音频转换失败 / 服务器未安装音频转换依赖	服务端环境或转码过程异常。