openapi/capcut-mate/v1/str_list_to_objs：字符串列表转对象列表/openapi/capcut-mate/v1/str_to_list：字符串转列表/openapi/capcut-mate/v1/objs_to_str_list：对象列表转字符串列表文档从架构设计、数据模型、处理流程、错误处理、性能优化与最佳实践等维度进行系统阐述，并提供可视化图示帮助理解。

本接口用于从输入内容中提取链接信息，当前版本实现为“多值返回变成单值返回”的直通逻辑，即直接返回输入内容，不做额外处理。接口遵循统一的请求/响应模型与错误处理机制，便于在内容处理流程中作为上游数据清洗与标准化环节使用。接口信息方法：POST路径：/openapi/capcut-mate/v1/get_url请求参数output：字符串，必填响应字段output：字符串错误码400：参数校验失败（如

图片信息生成接口（/v1/imgs_infos）是一个用于根据图片URL和时间线生成图片信息的API接口。该接口支持为多张图片设置不同的显示参数、入场出场动画、循环动画和转场效果，是剪映草稿制作流程中的重要组成部分。新版本引入了智能参数修剪和优雅降级机制，当输入参数长度不匹配时会自动处理而不是直接抛出异常。将图片URL与时间线信息进行智能匹配为每张图片生成独立的显示配置支持多动画类型和动画参数配置

特效信息生成接口（/effect_infos）是 CapCut Mate API 的核心功能模块之一，专门用于根据特效名称和时间线生成特效信息。该接口为视频编辑流程提供了灵活的特效管理能力，支持多种特效类型包括滤镜效果、转场效果和创意特效。该接口现已具备智能参数修剪和优雅降级机制，能够在参数长度不匹配时自动调整并继续处理，而不是直接抛出错误。智能参数修剪：自动处理长度不匹配的参数，以最短长度为准优

v1/audio_infos：根据音频 URL 和时间线生成音频信息/v1/imgs_infos：根据图片 URL 和时间线生成图片信息/v1/video_infos：根据视频 URL 和时间线生成视频信息/v1/caption_infos：根据文本和时间线生成字幕信息/v1/effect_infos：根据特效名称和时间线生成特效信息/v1/keyframes_infos：根据关键帧类型、位置比例

关键帧信息生成接口（/keyframes_infos）是CapCut Mate项目中的一个重要API端点，专门用于根据关键帧类型、位置比例和数值生成关键帧信息。该接口支持多种动画属性类型，包括位置、缩放、旋转、透明度等，为视频编辑提供强大的动画控制能力。该接口的核心功能是将用户提供的关键帧参数转换为剪映草稿系统可识别的关键帧数据格式，支持线性插值算法，并提供完整的错误处理和日志记录机制。

本文档是遮罩效果接口的详细 API 文档，涵盖遮罩的创建与应用流程，包括遮罩形状定义、几何参数配置、羽化与反相效果；解释遮罩坐标系统、尺寸调整、旋转角度与圆角处理；说明遮罩的实时预览、多遮罩叠加与遮罩与视频内容的合成规则；并提供最佳实践、性能建议、常见问题与调试方法。接口路径：POST /openapi/capcut-mate/v1/add_masks请求体字段draft_url：草稿 URL（必

文字样式接口是 CapCut Mate 剪映自动化工具的核心功能模块，专门用于为文本内容创建富文本样式。该接口支持关键词高亮、颜色配置、字体大小调整和文本装饰效果，为视频编辑软件提供完整的文字样式处理能力。关键词高亮处理：支持多关键词识别和高亮显示字体大小继承：智能继承和应用字体大小设置样式链式组合：支持复杂样式的组合和叠加参数化配置：灵活的参数化样式配置选项动态样式生成：实时生成和应用样式效果。

特效应用接口是剪映草稿管理系统的重要组成部分，负责向现有草稿中添加各种视频特效。该接口支持多种特效类型，包括边框特效、滤镜特效、动态特效、过渡效果等，为视频编辑提供了强大的视觉效果增强能力。系统现已支持更丰富的特效类型，包括过渡效果如"淡入"、"淡出"以及各种颜色滤镜效果。同时需要注意的是，某些特效在预览模式下可能不可见，但在最终视频生成时会正常应用。本接口采用RESTful API设计，通过HT

CapCut Mate 是一个基于 Python 的剪映草稿处理系统，专门用于自动化视频编辑工作流。滤镜系统是该系统的核心功能之一，允许用户向视频草稿中添加各种视觉滤镜效果，包括复古、黑白、电影感等多种风格的滤镜。该系统提供了完整的滤镜管理能力，包括滤镜元数据定义、滤镜片段创建、轨道管理和API接口等。通过统一的API接口，开发者可以轻松地在视频编辑流程中集成滤镜效果。: 添加滤镜的请求参数模型F