跳到主要内容

Get_Timelines - 获取时间线

通过音频链接自动获取音频文件的准确时长信息，生成标准的时间线数据。

重要更新

原插件中的 Audios_Timelines 功能已弃用，请使用技师插件库的 Get_Timelines。

📋 功能说明​

Get_Timelines 是一个独立的插件，用于自动获取音频文件的时长信息，为后续的素材添加提供准确的时间线数据。这是剪映小助手工作流中的重要环节。

📥 安装地址​

插件地址：https://www.coze.cn/store/plugin/7503016228110434330

📥 输入参数​

参数名类型必填说明
linksArray✅音频链接数组，单个音频请使用 Str_Array 转换

📤 输出参数​

参数名类型说明
timelinesArray每个音频的时间线信息，时间单位微秒
all_timelinesArray所有音频的总时长信息

💡 请求示例​

单个音频​

{
  "links": ["https://www.coze.cn/audio.mp3"]
}

多个音频​

{
  "links": [
    "https://www.coze.cn/audio1.mp3",
    "https://www.coze.cn/audio2.mp3"
  ]
}

📋 响应示例​

单个音频响应​

{
  "timelines": [
    {"start": 0, "end": 5230000}      // 音频时长：5.23秒
  ],
  "all_timelines": [
    {"start": 0, "end": 5230000}      // 总时长：5.23秒
  ]
}

多个音频响应​

{
  "timelines": [
    {"start": 0, "end": 5230000},      // 第一个音频：5.23秒
    {"start": 0, "end": 3450000}       // 第二个音频：3.45秒
  ],
  "all_timelines": [
    {"start": 0, "end": 8680000}       // 总时长：8.68秒
  ]
}

🔗 在工作流中的位置​

推荐工作流顺序​

graph TD
    A[Create_Draft<br/>创建草稿] --> B[Get_Timelines<br/>获取音频时长]
    B --> C[Add_Audios<br/>添加音频]
    B --> D[Add_Images<br/>添加图片]
    B --> E[Add_Captions<br/>添加字幕]
    C --> F[完成草稿]
    D --> F
    E --> F

使用示例​

// 步骤1：创建草稿
{
  "height": 1920,
  "width": 1080
}

// 步骤2：获取音频时间线
{
  "links": ["https://example.com/speech.mp3"]
}

// 步骤3：使用时间线添加音频
{
  "ids": "{{Create_Draft.ids}}",
  "mp3_urls": ["https://example.com/speech.mp3"],
  "timelines": "{{Get_Timelines.timelines}}"
}

⏱️ 时间单位说明​

微秒计算​

  • 1秒 = 1,000,000 微秒
  • 0.5秒 = 500,000 微秒
  • 2.5秒 = 2,500,000 微秒

时间线格式​

{
  "start": 0,        // 开始时间（微秒）
  "end": 3450000     // 结束时间（微秒）
}

🎯 使用场景​

音频配音视频​

// 获取语音时长
{
  "links": ["https://example.com/narration.mp3"]
}

// 根据语音时长添加背景图
{
  "ids": "{{Create_Draft.ids}}",
  "images": ["https://example.com/background.jpg"],
  "timelines": "{{Get_Timelines.timelines}}"
}

音乐视频制作​

// 获取背景音乐时长
{
  "links": ["https://example.com/bgm.mp3"]
}

// 根据音乐节拍添加图片切换
{
  "ids": "{{Create_Draft.ids}}",
  "images": ["https://example.com/img1.jpg", "https://example.com/img2.jpg"],
  "timelines": [
    {"start": 0, "end": 15000000},
    {"start": 15000000, "end": 30000000}
  ]
}

🔄 与旧版本对比​

性能提升​

功能Audios_Timelines (旧)Get_Timelines (新)
处理速度慢快
准确性一般高
稳定性一般优秀
支持格式有限丰富

迁移指南​

如果您之前使用 Audios_Timelines，请：

  1. 安装新的 Get_Timelines 插件
  2. 替换工作流中的节点
  3. 参数名称和格式保持不变

⚠️ 注意事项​

  1. 插件依赖：需要单独安装 Get_Timelines 插件
  2. 网络访问：音频 URL 必须可以正常访问
  3. 格式支持：支持 MP3、WAV、M4A 等主流格式
  4. 文件大小：建议音频文件不超过 100MB

🔧 故障排除​

Q: Get_Timelines 无法获取时长？ A: 确认音频 URL 有效，音频格式受支持。

Q: 时间线数据格式错误？ A: 使用 Get_Timelines 的标准输出，不要手动修改格式。

Q: 插件找不到？ A: 确认已安装 Get_Timelines 插件，插件地址：https://www.coze.cn/store/plugin/7503016228110434330

🎯 相关功能​