添加特效接口：说明该接口在草稿自动化里的用途、依赖模块与常见报错。具体方法、路径、字段和校验请以OpenAPI为准。

capcut-mate 通过清晰的分层架构与完善的 API 描述，实现了从草稿创建、素材编排到云端渲染与本地导出的全链路自动化。：完善的开源免费、独立部署和智能视频编辑支持进一步提升了项目的实用性，结合桌面客户端与容器化部署，项目可在多种场景下高效落地，支持多语言环境下的视频制作工作流，特别适合大模型驱动的智能视频创作应用。项目采用"API 层—服务层—工具层—自动化层"的分层设计，配合模板与草稿

本项目“capcut-mate”是一个面向剪映（CapCut）的自动化辅助系统，提供草稿管理、媒体素材处理、特效与字幕集成、以及视频导出能力。系统采用前后端分离策略：后端为基于 FastAPI 的 Web API，前端为 Electron 桌面应用，二者通过 IPC 和 HTTP 协议进行交互；capcut-mate 项目通过清晰的分层架构与前后端分离策略，实现了对剪映的自动化控制与 API 服务

本项目为 CapCut Mate（剪映小助手），旨在提供一套完整的视频草稿自动化处理能力，包括草稿下载、素材管理、草稿生成与导出、以及桌面客户端交互。技术栈围绕 Python 后端（FastAPI + Uvicorn）、前端（React + Vite + Electron）、以及自动化控制（uiautomation）构建，同时提供容器化部署能力。

capcut-mate 是一个面向 CapCut（剪映）的自动化脚本与 API 平台，提供草稿管理、媒体处理、编辑效果系统与视频生成流程的完整能力。通过标准化的 REST API，用户可以快速创建草稿、批量添加视频/音频/图片/字幕/特效，以及异步生成视频。项目采用 FastAPI 提供接口，结合本地草稿缓存与剪映自动化控制，实现从“素材装配”到“云端渲染”的端到端工作流。

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：根据关键帧类型、位置比例