跳到主要内容

Add_Audios - 添加音频

向草稿中添加音频素材，支持背景音乐、音效和语音等多种音频内容。

📋 功能说明​

Add_Audios 节点允许您向剪映草稿中添加音频文件，并可以控制音量、特效等属性。

🌐 API调用​

接口地址​

POST https://jy-api.0x0.chat/v1/add_audios.php

请求头​

Content-Type: application/json

📥 输入参数​

参数名类型必填说明
idsString✅通过 Create_Draft 获取的草稿 ID
mp3_urlsArray✅音频地址数组，单个音频请使用 Str_Array 转换
timelinesArray✅音频播放的时间线数组
audio_effectString❌音频特效名称
volumeNumber❌音量大小，范围 0.1-10

💡 请求示例​

HTTP请求示例​

curl -X POST https://jy-api.0x0.chat/v1/add_audios.php \
  -H "Content-Type: application/json" \
  -d '{
    "ids": "c7f3042a-6741-1bad-02a0-0f2ac1527e5f/36788c0f-70d0-4c8a-b77f-613c4173ff42",
    "mp3_urls": ["https://example.com/audio.mp3"],
    "timelines": [{"start": 0, "end": 10000000}],
    "volume": 0.8
  }'

基础用法​

{
  "ids": "c7f3042a-6741-1bad-02a0-0f2ac1527e5f/36788c0f-70d0-4c8a-b77f-613c4173ff42",
  "mp3_urls": ["https://3w.org/a.mp3", "https://3w.org/b.mp3"],
  "timelines": [
    {"start": 0, "end": 1000000},
    {"start": 1000000, "end": 3000000}
  ],
  "volume": 0.2
}

多音频添加​

{
  "ids": "{{Create_Draft.ids}}",
  "mp3_urls": [
    "https://example.com/bgm.mp3",
    "https://example.com/effect.mp3"
  ],
  "timelines": [
    {"start": 0, "end": 10000000},     // 背景音乐：0-10秒
    {"start": 2000000, "end": 3000000} // 音效：2-3秒
  ],
  "volume": 0.8  // 音量80%
}

带音效处理​

{
  "ids": "{{Create_Draft.ids}}",
  "mp3_urls": ["https://example.com/voice.mp3"],
  "timelines": [{"start": 0, "end": 8000000}],
  "audio_effect": "回声",  // 添加回声效果
  "volume": 1.2           // 音量120%
}

🔊 音量控制​

音量范围​

  • 最小值：0.1 (10%)
  • 默认值：1.0 (100%)
  • 最大值：10.0 (1000%)

音量建议​

音频类型推荐音量说明
背景音乐0.3-0.6不要盖过主要内容
语音旁白0.8-1.2确保清晰可听
音效0.5-1.5根据需要调整

🎵 音频格式支持​

支持的格式​

  • MP3 - 推荐使用，兼容性最好
  • WAV - 高质量音频
  • M4A - Apple 格式
  • AAC - 压缩格式

音频质量建议​

  • 采样率：44.1kHz 或 48kHz
  • 比特率：128kbps 以上
  • 声道：单声道或立体声

⏰ 时间线配置​

获取音频时长​

使用 Get_Timelines 插件自动获取音频时长：

// Get_Timelines 插件输出示例
{
  "timelines": [
    {"start": 0, "end": 5230000},      // 第一个音频：5.23秒
    {"start": 0, "end": 3450000}       // 第二个音频：3.45秒
  ]
}

手动设置时间线​

{
  "timelines": [
    {"start": 0, "end": 3000000},        // 0-3秒
    {"start": 5000000, "end": 8000000}   // 5-8秒（中间有2秒静音）
  ]
}

🎛️ 音频特效​

常用特效​

  • 回声 - 增加空间感
  • 混响 - 营造氛围
  • 降噪 - 提升音质
  • 变声 - 特殊效果
{
  "audio_effect": "混响",
  "volume": 0.9
}

⚠️ 注意事项​

  1. 数组长度：音频数组与时间线数组长度必须一致
  2. 音频格式：确保音频文件格式受剪映支持
  3. 网络访问：音频 URL 必须可以正常访问
  4. 时长匹配：建议使用 Get_Timelines 获取准确时长

🔧 故障排除​

Q: 音频无法播放？ A: 检查音频 URL 有效性和格式支持。

Q: 音量太小或太大？ A: 调整 volume 参数，范围是 0.1-10。

Q: 音频时长不匹配？ A: 使用 Get_Timelines 插件获取准确的音频时长信息。

🎯 相关功能​