GET_AUDIO_DURATION API 接口文档
接口信息
POST /openapi/capcut-mate/v1/get_audio_duration
更多文档
📖 更多详细文档和教程请访问：https://docs.jcaigc.cn
功能描述
获取音频文件的时长，支持各种常见的音频格式。使用FFprobe工具进行精确的音频分析，返回音频文件的准确时长，单位为微秒。
更多文档
📖 更多详细文档和教程请访问：https://docs.jcaigc.cn
请求参数
{
"mp3_url": "https://assets.jcaigc.cn/audio/sample.mp3"
}
参数说明
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| mp3_url | string | ✅ | - | 音频文件URL，支持mp3、wav、m4a等常见音频格式 |
参数详解
音频URL参数
- mp3_url: 音频文件的完整URL地址
- 支持格式：mp3、wav、aac、flac、m4a等常见音频格式
- 需要确保URL可访问且文件完整
响应格式
成功响应 (200)
{
"duration": 2325333
}
响应字段说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| duration | number | 音频时长，单位：微秒 |
错误响应 (4xx/5xx)
{
"detail": "错误信息描述"
}
使用示例
cURL 示例
1. 基本获取音频时长
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/get_audio_duration \
-H "Content-Type: application/json" \
-d '{
"mp3_url": "https://assets.jcaigc.cn/audio/sample.mp3"
}'
错误码说明
| 错误码 | 错误信息 | 说明 | 解决方案 |
|---|---|---|---|
| 400 | mp3_url是必填项 | 缺少音频URL参数 | 提供有效的mp3_url |
| 404 | 音频文件无法访问 | 指定的音频URL无效 | 检查音频URL是否正确 |
| 500 | 音频时长获取失败 | 内部处理错误 | 联系技术支持 |
注意事项
- 时间单位: 返回的时长使用微秒（1秒 = 1,000,000微秒）
- 音频格式: 支持mp3、wav、aac、flac、m4a等常见音频格式
- 文件大小: 建议控制在合理范围内，过大的文件可能导致处理超时
- 网络访问: 确保提供的音频URL可以正常访问
工作流程
- 验证必填参数（mp3_url）
- 下载音频文件到临时目录
- 使用ffprobe分析音频文件获取时长
- 清理临时文件
- 返回音频时长信息
相关接口
📚 项目资源
GitHub: https://github.com/Hommy-master/capcut-mate
Gitee: https://gitee.com/taohongmin-gitee/capcut-mate
📚 项目资源
GitHub: https://github.com/Hommy-master/capcut-mate
Gitee: https://gitee.com/taohongmin-gitee/capcut-mate
