FILTER_INFOS API Documentation

🌐 Language Switch

中文版 | English

Interface Information

POST /openapi/capcut-mate/v1/filter_infos

Function Description

Generate filter information based on filter names, timelines, and intensities. This interface converts filter names and timeline configurations into the filter information format required by Jianying drafts.

Request Parameters

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

Parameter Description

Parameter	Type	Required	Default	Description
filters	array[string]	✅	-	Filter name array
timelines	array[object]	✅	-	Timeline configuration array
intensities	array[number]	❌	None	Filter intensity array (0-100), optional, defaults to 100 for all

Response Format

Success Response (200)

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

Response Field Description

Field	Type	Description
infos	string	Filter information JSON string

Error Response

{
  "code": 1001,
  "message": "Parameter validation failed"
}

Usage Examples

cURL Examples

1. Basic Filter Information Generation

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. Filter Information with Custom Intensity

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. Multiple Filter Information Generation

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]
  }'

Error Code Description

Error Code	Error Message	Description	Solution
1001	Parameter validation failed	Request body failed schema validation (filters/timelines missing, timeline item lacking start/end, or wrong types)	Check parameter types and required fields

Notes

1. Array Matching: filters, timelines and intensities are aligned by the shortest length when their lengths differ (no hard error)
2. Time Unit: All time parameters use microseconds (1 second = 1,000,000 microseconds)
3. Filter Names: Need to use system-supported filter names
4. Intensity Range: Intensity values are clamped to 0-100, default is 100
5. Continuity: Filters are applied in timeline order

Workflow

1. Validate required parameters (filters, timelines)
2. Align the arrays by the shorter length
3. Validate timeline parameter validity
4. Clamp intensity values to the 0-100 range (if provided)
5. Generate corresponding filter information for each filter name
6. Convert information to JSON string format
7. Return processing result

Related Interfaces

• Create Draft
• Add Filters
• Timelines
• Save Draft

---

📚 Project Resources
GitHub: https://github.com/Hommy-master/capcut-mate
Gitee: https://gitee.com/taohongmin-gitee/capcut-mate

Language Switch

中文版 | English