跳到主要内容

Add_Videos - 添加视频

向草稿中添加视频素材，支持多种视频格式和特效处理。

📋 功能说明​

Add_Videos 节点允许您向剪映草稿中添加视频文件，支持视频特效和时间线控制。

🌐 API调用​

接口地址​

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

请求头​

Content-Type: application/json

📥 输入参数​

参数名类型必填说明
idsString✅通过 Create_Draft 获取的草稿 ID
video_urlsArray✅视频地址数组，单个视频请使用 Str_Array 转换
timelinesArray✅视频播放的时间线数组
transform_xInteger❌X轴位置调整，基于画布大小
transform_yInteger❌Y轴位置调整，基于画布大小
scale_xNumber❌X轴缩放比例
scale_yNumber❌Y轴缩放比例
volumeNumber❌音量控制：0=静音，1=开启（默认1）

💡 请求示例​

基础用法​

{
  "ids": "{{Create_Draft.ids}}",
  "video_urls": ["https://example.com/video1.mp4"],
  "timelines": [{"start": 0, "end": 5000000}]  // 播放5秒
}

多视频拼接​

{
  "ids": "{{Create_Draft.ids}}",
  "video_urls": [
    "https://example.com/intro.mp4",
    "https://example.com/main.mp4",
    "https://example.com/outro.mp4"
  ],
  "timelines": [
    {"start": 0, "end": 3000000},      // 开场：0-3秒
    {"start": 3000000, "end": 15000000}, // 主体：3-15秒
    {"start": 15000000, "end": 18000000} // 结尾：15-18秒
  ]
}

带属性调整​

{
  "ids": "{{Create_Draft.ids}}",
  "video_urls": ["https://example.com/background.mp4"],
  "timelines": [{"start": 0, "end": 10000000}],
  "transform_y": -600,  // 向上移动
  "scale_x": 0.8,       // X轴缩放80%
  "scale_y": 0.8,       // Y轴缩放80%
  "volume": 0.3         // 音量30%（作为背景视频）
}

🎬 视频格式支持​

支持的格式​

  • MP4 - 推荐使用，兼容性最好
  • MOV - Apple 格式
  • AVI - Windows 格式
  • MKV - 高质量格式

视频质量建议​

  • 分辨率：1080p 或以上
  • 帧率：24fps、30fps 或 60fps
  • 编码：H.264 或 H.265
  • 比特率：适中即可，过高影响加载速度

📐 位置和缩放​

位置调整​

{
  "transform_x": 200,   // 向右移动200像素
  "transform_y": -400   // 向上移动400像素
}

缩放设置​

{
  "scale_x": 1.2,  // X轴放大120%
  "scale_y": 0.8   // Y轴缩小至80%
}

常用位置配置​

位置transform_xtransform_y说明
居中00默认位置
左上角-400-600画面左上
右下角400600画面右下
底部0600底部居中

🔊 音量控制​

音量设置​

  • 静音："volume": 0
  • 正常："volume": 1 （默认）
  • 降低："volume": 0.1-0.9
  • 增强："volume": 1.1-2.0

使用场景​

// 背景视频（静音）
{
  "volume": 0
}

// 主要内容视频
{
  "volume": 1
}

// 背景音乐视频（降低音量）
{
  "volume": 0.3
}

⏰ 时间线配置​

视频片段剪辑​

{
  "video_urls": ["https://example.com/long-video.mp4"],
  "timelines": [
    {"start": 5000000, "end": 15000000}  // 只使用5-15秒片段
  ]
}

视频循环播放​

{
  "video_urls": ["https://example.com/short-clip.mp4"],
  "timelines": [
    {"start": 0, "end": 3000000},      // 第一次播放
    {"start": 3000000, "end": 6000000}, // 第二次播放
    {"start": 6000000, "end": 9000000}  // 第三次播放
  ]
}

🎯 使用场景​

背景视频​

{
  "video_urls": ["https://example.com/background.mp4"],
  "timelines": [{"start": 0, "end": 30000000}],
  "scale_x": 1.2,
  "scale_y": 1.2,
  "volume": 0  // 静音背景
}

画中画效果​

{
  "video_urls": ["https://example.com/pip-video.mp4"],
  "timelines": [{"start": 5000000, "end": 15000000}],
  "transform_x": 300,
  "transform_y": -300,
  "scale_x": 0.4,
  "scale_y": 0.4
}

视频转场​

{
  "video_urls": [
    "https://example.com/scene1.mp4",
    "https://example.com/scene2.mp4"
  ],
  "timelines": [
    {"start": 0, "end": 8000000},      // 场景1
    {"start": 8000000, "end": 16000000} // 场景2
  ]
}

⚠️ 注意事项​

  1. 数组长度：视频数组与时间线数组长度必须一致
  2. 视频格式：确保视频格式受剪映支持
  3. 文件大小：过大的视频文件可能影响处理速度
  4. 网络访问：视频 URL 必须可以正常访问

🔧 故障排除​

Q: 视频无法播放？ A: 检查视频 URL 有效性和格式支持，确保文件可以直接访问。

Q: 视频位置不正确？ A: 调整 transform_x 和 transform_y 参数，可在剪映中预览效果。

Q: 视频画质模糊？ A: 检查原视频质量和缩放比例，避免过度缩放。

Q: 音画不同步？ A: 确保时间线设置正确，检查原视频是否存在音画同步问题。

🎯 相关功能​