GET_AUDIO_DURATION API 接口文档
接口信息
- 请求方式: POST
- 接口地址:
/openapi/capcut-tools/v1/get_audio_duration
功能描述
获取音频文件的时长，支持各种常见的音频格式。使用 FFprobe 工具进行精确的音频分析，返回音频文件的准确时长，单位为微秒。
更多文档: 📖 速创 AIGC-工具平台官方文档
请求参数
{
"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://agent.aigc-ai.com/openapi/capcut-tools/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 分析音频文件获取时长
- 清理临时文件
- 返回音频时长信息
相关接口