简创AIGC官方文档 - 剪映小助手API文档主题切换
IMGS_INFOS API 接口文档
🌐 语言切换
接口信息
POST /openapi/capcut-mate/v1/imgs_infos
功能描述
根据图片URL和时间线生成图片信息。该接口将图片文件URL和时间线配置转换为剪映草稿所需的图片信息格式，支持动画效果和转场设置。
更多文档
📖 更多详细文档和教程请访问：https://docs.jcaigc.cn
请求参数
json
{
"imgs": ["https://assets.jcaigc.cn/img1.jpg", "https://assets.jcaigc.cn/img2.png"],
"timelines": [
{"start": 0, "end": 3000000},
{"start": 3000000, "end": 6000000}
],
"height": 1080,
"width": 1920,
"in_animation": "fade_in",
"in_animation_duration": 500000,
"loop_animation": "bounce",
"loop_animation_duration": 1000000,
"out_animation": "fade_out",
"out_animation_duration": 500000,
"transition": "cross_fade",
"transition_duration": 300000
}
参数说明
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| imgs | array[string] | ✅ | - | 图片文件URL数组 |
| timelines | array[object] | ✅ | - | 时间线配置数组 |
| height | number | ❌ | 1080 | 图片高度 |
| width | number | ❌ | 1920 | 图片宽度 |
| in_animation | string | ❌ | None | 入动画效果 |
| in_animation_duration | number | ❌ | 500000 | 入时长(微秒) |
| loop_animation | string | ❌ | None | 循动画效果 |
| loop_animation_duration | number | ❌ | 1000000 | 循动画时长(微秒) |
| out_animation | string | ❌ | None | 出动画效果 |
| out_animation_duration | number | ❌ | 500000 | 出动画时长(微秒) |
| transition | string | ❌ | None | 转场效果 |
| transition_duration | number | ❌ | 300000 | 转场时长(微秒) |
##响应格式
成功响应 (200)
json
{
"infos": "[{\"img_url\":\"https://assets.jcaigc.cn/img1.jpg\",\"start\":0,\"end\":3000000,\"duration\":5000000,\"height\":1080,\"width\":1920,\"in_animation\":\"fade_in\",\"in_animation_duration\":500000,\"loop_animation\":\"bounce\",\"loop_animation_duration\":1000000,\"out_animation\":\"fade_out\",\"out_animation_duration\":500000,\"transition\":\"cross_fade\",\"transition_duration\":300000},{\"img_url\":\"https://assets.jcaigc.cn/img2.png\",\"start\":3000000,\"end\":6000000,\"duration\":5000000,\"height\":1080,\"width\":1920,\"in_animation\":\"fade_in\",\"in_animation_duration\":500000,\"loop_animation\":\"bounce\",\"loop_animation_duration\":1000000,\"out_animation\":\"fade_out\",\"out_animation_duration\":500000,\"transition\":\"cross_fade\",\"transition_duration\":300000}]"
}
###响应字段说明
| 字段名 | 类型 | 说明 |
|---|---|---|
| infos | string | 图片信息JSON字符串 |
###错误响应 (4xx/5xx)
json
{
"detail": "错误信息描述"
}
使用示例
cURL 示例
1.基本图片信息生成
bash
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/imgs_infos \
-H "Content-Type: application/json" \
-d '{
"imgs": ["https://assets.jcaigc.cn/cover.jpg"],
"timelines": [{"start": 0, "end": 5000000}],
"height": 1080,
"width": 1920
}'
2.带动画效果的图片信息
bash
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/imgs_infos \
-H "Content-Type: application/json" \
-d '{
"imgs": ["https://assets.jcaigc.cn/slide1.jpg", "https://assets.jcaigc.cn/slide2.jpg"],
"timelines": [{"start": 0, "end": 3000000}, {"start": 3000000, "end": 6000000}],
"in_animation": "fade_in",
"loop_animation": "bounce",
"out_animation": "fade_out",
"transition": "cross_fade"
}'
##错误码说明
| 错误码 | 错误信息 | 说明 | 解决方案 |
|---|---|---|---|
| 400 | imgs是必填项 | 缺少图片URL参数 | 提供有效的图片URL数组 |
| 400 | timelines是必填项 | 缺少时间线参数 | 提供有效的时间线数组 |
| 400 | 数组长度不匹配 | imgs和timelines长度不一致 | 确保两个数组长度相同 |
| 404 | 图片资源不存在 | 图片URL无法访问 | 检查图片URL是否可访问 |
| 500 | 图片信息生成失败 | 内部处理错误 | 联技术支持 |
注意事项
- 数组匹配: imgs和timelines数组长度必须相同
- 时间单位:所有时间参数使用微秒（1秒 = 1,000,000微秒）
- 分辨率设置: height和width参数用于设置图片显示分辨率
- 动画效果:支持入动画、循环动画、出动画和转场效果
- 网络访问: 图片URL必须可以正常访问
- 格式支持:支持常见的图片格式（JPG、PNG、GIF等）
##工作流程
1.验证必填参数（imgs, timelines） 2.检查数组长度匹配 3.验证时间线参数有效性 4. 设置图片分辨率参数 5.应用动画效果参数 6.为每图片URL生成对应的图片信息 7.将信息转换为JSON字符串格式 8.返回处理结果
##相关接口
📚 项目资源
GitHub: https://github.com/Hommy-master/capcut-mate
Gitee: https://gitee.com/taohongmin-gitee/capcut-mate