简创AIGC官方文档 - 剪映小助手API文档

主题切换

返回顶部
当前页导航

FILTER_INFOS API 接口文档

🌐 语言切换

中文版 | English

接口信息 

POST /openapi/capcut-mate/v1/filter_infos

功能描述

根据滤镜名称、时间线和强度生成滤镜信息。该接口将滤镜名称和时间线配置转换为剪映草稿所需的滤镜信息格式。

更多文档

📖 更多详细文档和教程请访问：https://docs.jcaigc.cn

请求参数

json
{
  "filters": ["复古", "黑白"],
  "timelines": [
    {"start": 0, "end": 3000000},
    {"start": 3000000, "end": 6000000}
  ],
  "intensities": [80, 100]
}

参数说明

参数名类型必填默认值说明
filtersarray[string]✅-滤镜名称数组
timelinesarray[object]✅-时间线配置数组
intensitiesarray[number]❌100滤镜强度数组(0-100)，可选，默认全部为100

响应格式

成功响应 (200)

json
{
  "infos": "[{\"filter_title\":\"复古\",\"start\":0,\"end\":3000000,\"intensity\":80},{\"filter_title\":\"黑白\",\"start\":3000000,\"end\":6000000,\"intensity\":100}]"
}

响应字段说明

字段名类型说明
infosstring滤镜信息JSON字符串

错误响应 (4xx/5xx)

json
{
  "detail": "错误信息描述"
}

使用示例

cURL 示例

1. 基本滤镜信息生成

bash
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/filter_infos \
  -H "Content-Type: application/json" \
  -d '{
    "filters": ["复古"],
    "timelines": [{"start": 0, "end": 5000000}]
  }'

2. 自定义强度的滤镜信息生成

bash
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/filter_infos \
  -H "Content-Type: application/json" \
  -d '{
    "filters": ["黑白"],
    "timelines": [{"start": 0, "end": 5000000}],
    "intensities": [60]
  }'

3. 多滤镜信息生成

bash
curl -X POST https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1/filter_infos \
  -H "Content-Type: application/json" \
  -d '{
    "filters": ["复古", "黑白", "电影感"],
    "timelines": [{"start": 0, "end": 2000000}, {"start": 2000000, "end": 4000000}, {"start": 4000000, "end": 6000000}],
    "intensities": [80, 100, 90]
  }'

错误码说明

错误码错误信息说明解决方案
400filters是必填项缺少滤镜名称参数提供有效的滤镜名称数组
400timelines是必填项缺少时间线参数提供有效的时间线数组
400数组长度不匹配filters、timelines、intensities长度不一致确保所有数组长度相同
400强度范围无效intensity必须在0-100之间提供有效的强度值
500滤镜信息生成失败内部处理错误联系技术支持

注意事项

  1. 数组匹配: filters和timelines数组长度必须相同；如果提供intensities，长度也应相同
  2. 时间单位: 所有时间参数使用微秒（1秒 = 1,000,000微秒）
  3. 滤镜名称: 需要使用系统支持的滤镜名称
  4. 强度范围: 强度值必须在0-100之间，默认为100
  5. 连续性: 滤镜按时间线顺序应用

工作流程

  1. 验证必填参数（filters, timelines）
  2. 检查数组长度匹配
  3. 验证时间线参数有效性
  4. 验证强度范围（如果提供）
  5. 为每个滤镜名称生成对应的滤镜信息
  6. 将信息转换为JSON字符串格式
  7. 返回处理结果

相关接口

语言切换

中文版 | English

版权所有 © 2025 简创AIGC