【剪映小助手】获取音频文件的时长

简介: 获取音频文件的时长,支持各种常见的音频格式。使用FFprobe工具进行精确的音频分析,返回音频文件的准确时长,单位为微秒。

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秒 = 1,000,000微秒)
  2. 音频格式: 支持mp3、wav、aac、flac、m4a等常见音频格式
  3. 文件大小: 建议控制在合理范围内,过大的文件可能导致处理超时
  4. 网络访问: 确保提供的音频URL可以正常访问

工作流程

  1. 验证必填参数(mp3_url)
  2. 下载音频文件到临时目录
  3. 使用ffprobe分析音频文件获取时长
  4. 清理临时文件
  5. 返回音频时长信息

相关接口


相关文章
|
8月前
|
API
开源剪映小助手(capcut-mate)v3.0.22发布
CapCut Mate API 是开源免费的剪映草稿自动化工具,基于 FastAPI,支持独立部署。为大模型提供开箱即用的视频编辑 Skills,实现剪映核心功能全流程自动化,轻松生成专业视频。兼容 Coze/n8n,支持云渲染。
1970 1
|
2月前
|
编解码 人工智能 自然语言处理
阿里云图片生成与编辑模型解析:适合文生图、图片编辑等场景
本文介绍了阿里云百炼平台的AI图像生成与编辑模型体系,针对海报设计、品牌素材、批量写实图产出等主流业务场景,系统梳理全系列模型的能力边界与选型逻辑。文章提供Midjourney、FLUX.2等主流闭源图像模型向百炼生态平滑迁移的对位对照表,拆解文生图、精细修图、品牌色管控、角色一致性生成等核心能力的适配方案,汇总Wan、Qwen Image、Z-Image三大系列的详细参数矩阵,最终给出分场景的精准选型建议,帮助开发者根据质量、速度、成本的不同优先级,灵活组合模型实现业务效果与投入的最优平衡。
|
7月前
|
缓存 监控 API
【开源剪映小助手】媒体处理功能
CapCut Mate是基于剪映的专业视频编辑辅助工具,提供视频、音频、图片、字幕的智能添加、处理与时间线管理。采用FastAPI架构,集成UI自动化控制、多级缓存及异步任务调度,支持微秒级精度编排与完善错误恢复,兼顾高性能与高可用性。(239字)
|
7月前
|
存储 人工智能 中间件
【开源剪映小助手】项目介绍
CapCut Mate API 是一款开源免费的剪映自动化工具,基于 FastAPI 构建,支持本地/云端部署。深度集成大模型,实现草稿创建、智能剪辑、云端渲染等全流程自动化,可无缝对接 Coze/n8n,赋能个人创作者、企业及教育机构高效产出专业视频。(239字)
1560 0
|
7月前
|
人工智能 自然语言处理 搜索推荐
不懂技术,也能用 hermes 丝滑搭建你的个人网站
不懂代码也能建站?本文分享使用 AI 助手 Hermes Agent,只需 4 条简单指令,就能低成本、快速搭建并上线一个高颜值的个人网站。告别繁琐技术门槛,让你的创意轻松落地。
1050 3
|
人工智能 监控 安全
AI智能体落地:Agent-Assist vs 全自动化完整决策指南
2025年Agentic AI迅猛发展,但全自主智能体风险难控。Agent-Assist(人机协同)模式兼顾效率与安全,通过人类反馈持续学习,结合RAG构建组织知识库,实现AI越用越聪明。适合高风险、强依赖上下文的场景,是企业智能化升级的更优路径。
883 4
AI智能体落地:Agent-Assist vs 全自动化完整决策指南
|
11月前
|
JSON API 数据安全/隐私保护
【剪映小助手】批量向现有草稿中添加视频素材
批量向现有草稿中添加视频素材。该接口是一个功能强大的视频添加工具,支持多个视频的批量处理,包括时间范围控制、透明度调整、遮罩效果、转场动画、音量控制、缩放变换等高级功能。特别适合创建复杂的多视频组合场景,如画中画效果、视频拼接、过渡动画等。
1072 0
|
11月前
|
编解码 缓存 API
【剪映小助手】在现有草稿中添加多种类型的素材内容
在现有草稿中添加多种类型的素材内容,包括音频、视频、图片和文字。该接口可以一次性向草稿添加多种媒体素材,自动处理素材的时长、尺寸等属性,并智能管理不同类型的媒体轨道。是视频创作的核心接口之一。
1109 0
|
前端开发
前端input上传文件获取视频或音频的时长
前端input上传文件获取视频或音频的时长
944 0
|
Python
python获取音频时长
python获取音频时长
1107 0