mirror of
https://github.com/Hommy-master/capcut-mate.git
synced 2026-09-19 01:44:11 +08:00
126 lines
3.1 KiB
Markdown
126 lines
3.1 KiB
Markdown
# GET_AUDIO_DURATION API 接口文档
|
||
|
||
## 接口信息
|
||
|
||
```
|
||
POST /openapi/capcut-mate/v1/get_audio_duration
|
||
```
|
||
|
||
## 更多文档
|
||
|
||
📖 更多详细文档和教程请访问：[https://docs.jcaigc.cn](https://docs.jcaigc.cn)
|
||
|
||
## 功能描述
|
||
|
||
获取音频文件的时长，支持各种常见的音频格式。使用FFprobe工具进行精确的音频分析，返回音频文件的准确时长，单位为微秒。
|
||
|
||
## 更多文档
|
||
|
||
📖 更多详细文档和教程请访问：[https://docs.jcaigc.cn](https://docs.jcaigc.cn)
|
||
|
||
## 请求参数
|
||
|
||
```json
|
||
{
|
||
"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)
|
||
|
||
```json
|
||
{
|
||
"duration": 2325333
|
||
}
|
||
```
|
||
|
||
### 响应字段说明
|
||
|
||
| 字段名 | 类型 | 说明 |
|
||
|--------|------|------|
|
||
| duration | number | 音频时长，单位：微秒 |
|
||
|
||
### 错误响应 (4xx/5xx)
|
||
|
||
```json
|
||
{
|
||
"detail": "错误信息描述"
|
||
}
|
||
```
|
||
|
||
## 使用示例
|
||
|
||
### cURL 示例
|
||
|
||
#### 1. 基本获取音频时长
|
||
|
||
```bash
|
||
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秒 = 1,000,000微秒）
|
||
2. **音频格式**: 支持mp3、wav、aac、flac、m4a等常见音频格式
|
||
3. **文件大小**: 建议控制在合理范围内，过大的文件可能导致处理超时
|
||
4. **网络访问**: 确保提供的音频URL可以正常访问
|
||
|
||
## 工作流程
|
||
|
||
1. 验证必填参数（mp3_url）
|
||
2. 下载音频文件到临时目录
|
||
3. 使用ffprobe分析音频文件获取时长
|
||
4. 清理临时文件
|
||
5. 返回音频时长信息
|
||
|
||
## 相关接口
|
||
|
||
- [添加音频](./add_audios.md)
|
||
- [添加视频](./add_videos.md)
|
||
- [创建草稿](./create_draft.md)
|
||
|
||
---
|
||
|
||
<div align="right">
|
||
|
||
📚 **项目资源**
|
||
**GitHub**: [https://github.com/Hommy-master/capcut-mate](https://github.com/Hommy-master/capcut-mate)
|
||
**Gitee**: [https://gitee.com/taohongmin-gitee/capcut-mate](https://gitee.com/taohongmin-gitee/capcut-mate)
|
||
|
||
</div>
|
||
|
||
<div align="right">
|
||
|
||
📚 **项目资源**
|
||
**GitHub**: [https://github.com/Hommy-master/capcut-mate](https://github.com/Hommy-master/capcut-mate)
|
||
**Gitee**: [https://gitee.com/taohongmin-gitee/capcut-mate](https://gitee.com/taohongmin-gitee/capcut-mate)
|
||
|
||
</div> |