跳到主要内容

Add_Images - 添加图片

向草稿中添加图片素材，支持设置动画特效、位置、大小等属性。

📋 功能说明​

Add_Images 节点允许您向剪映草稿中添加图片文件，支持多种动画特效和位置调整。

🌐 API调用​

接口地址​

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

请求头​

Content-Type: application/json

📥 输入参数​

参数名类型必填说明
idsString✅通过 Create_Draft 获取的草稿 ID
imagesArray✅图片地址数组，单个图片请使用 Str_Array 转换
timelinesArray✅图片显示的时间线数组
heightNumber❌图片高度，一般无需使用
widthNumber❌图片宽度，一般无需使用
transform_xInteger❌X轴位置调整，基于画布大小
transform_yInteger❌Y轴位置调整，基于画布大小
scale_xNumber❌X轴缩放比例
scale_yNumber❌Y轴缩放比例
in_animationString❌入场动画名称
in_animation_durationInteger❌入场动画时长（微秒）
out_animationString❌出场动画名称
out_animation_durationInteger❌出场动画时长（微秒）
loop_animationString❌循环动画（暂不支持）
loop_animation_durationInteger❌循环动画时长（暂不支持）

💡 请求示例​

基础用法​

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

带位置和动画效果​

{
  "ids": "{{Create_Draft.ids}}",
  "images": ["https://3w.org/a.jpg", "https://3w.org/b.jpg"],
  "timelines": [
    {"start": 0, "end": 1000000},
    {"start": 1000000, "end": 3000000}
  ],
  "transform_y": -600,
  "scale_x": 0.5,
  "scale_y": 0.5,
  "in_animation": "渐显",
  "in_animation_duration": 1500000
}

🎨 位置和缩放​

位置调整​

  • transform_x: 正值向右移动，负值向左移动
  • transform_y: 正值向下移动，负值向上移动
{
  "transform_x": 200,   // 向右移动200像素
  "transform_y": -300   // 向上移动300像素
}

缩放设置​

  • scale_x / scale_y: 1.0 为原始大小
  • 大于 1.0 为放大，小于 1.0 为缩小
{
  "scale_x": 1.5,  // X轴放大150%
  "scale_y": 0.8   // Y轴缩小至80%
}

✨ 动画效果​

支持的动画类型​

  • 入场动画：渐显、飞入、缩放等
  • 出场动画：渐隐、飞出、缩放等
动画限制

入场动画和出场动画仅可二选一，不能同时设置。

动画时长​

{
  "in_animation": "渐显",
  "in_animation_duration": 1000000  // 1秒 = 1,000,000微秒
}

📊 时间线配置​

单图片时间线​

{
  "timelines": [{"start": 0, "end": 5000000}]  // 显示5秒
}

多图片时间线​

{
  "timelines": [
    {"start": 0, "end": 2000000},        // 图片1：0-2秒
    {"start": 2000000, "end": 4000000},  // 图片2：2-4秒
    {"start": 4000000, "end": 6000000}   // 图片3：4-6秒
  ]
}

⚠️ 注意事项​

  1. 图片数量：图片数组长度必须与时间线数组长度一致
  2. 图片格式：支持 JPG、PNG、GIF 等常见格式
  3. 图片大小：建议使用适中分辨率，过大可能影响性能
  4. URL 有效性：确保图片链接可以正常访问

🔧 故障排除​

Q: 图片不显示怎么办？ A: 检查图片 URL 是否有效，确保可以直接访问。

Q: 动画效果不生效？ A: 确认动画名称正确，参考 动画特效列表。

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

🎯 相关功能​