1. 接口概述

本 API 提供基于 FFmpeg 的音频转换服务，支持从视频/音频 URL 提取并转换音频格式。

2. 基础信息

• 接口地址: http://newgmapi.liulikeji.cn/api/ffmpeg

• 请求方法: POST

• 请求格式: JSON

• 响应格式: JSON

3. 请求参数

请求体 (JSON)

参数名 类型 必填 说明 示例
input_url string 是 输入文件的URL地址 "http://example.com/audio.mp3"
args array 是 FFmpeg 音频处理参数 ["-c:a", "libvorbis", "-q:a", "4"]
output_format string 是 输出音频格式 (默认: mp3) "ogg"

常用音频参数示例

    // 转换为MP3格式
{
    "args": ["-vn", "-c:a", "libmp3lame", "-q:a", "2"],
    "output_format": "mp3"
}
    
    // 转换为OGG格式
{
    "args": ["-vn", "-c:a", "libvorbis", "-q:a", "4"],
    "output_format": "ogg"
}
    
    // 转换为48kHz单声道dfpwm
{
    "args": ["-vn", "-ar", "48000", "-ac", "1"],
    "output_format": "dfpwm"
}

4. 响应参数

参数名 类型 说明
status string 处理状态 ("success"/"error")
download_url string 完整下载URL
file_id string 文件唯一标识符
error string 错误信息(仅失败时返回)

成功响应示例

{

    "status": "success",

    "download_url": "http://your-server/download/3cff4a16/3cff4a16.mp3",

    "file_id": "3cff4a16"

}

失败响应示例

{

    "status": "error",

    "error": "Invalid input URL"

}

5. 状态码说明

状态码 说明
200 处理成功
400 请求参数错误
403 参数安全检查失败
404 文件不存在
500 服务器内部错误

6. 使用示例

Python 示例

import requests

url = "http://localhost:5000/api/ffmpeg"

data = {

    "input_url": "http://example.com/audio.mp3",

    "args": ["-ar", "48000", "-ac", "1"],

    "output_format": "wav"

}

response = requests.post(url, json=data)

print(response.json())

7. 注意事项

1. 文件下载链接有效期为2小时

8.请求测试

9.私有化部署

正在准备中....