【剪映小助手】添加文字样式接口（Add Text Style）

添加文字样式接口

简介

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

依赖关系分析

模块依赖图

#mermaid-svg-Ti3QvK9yUHW9tBxh{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-Ti3QvK9yUHW9tBxh .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-Ti3QvK9yUHW9tBxh .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-Ti3QvK9yUHW9tBxh .error-icon{fill:#552222;}#mermaid-svg-Ti3QvK9yUHW9tBxh .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-Ti3QvK9yUHW9tBxh .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-Ti3QvK9yUHW9tBxh .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-Ti3QvK9yUHW9tBxh .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-Ti3QvK9yUHW9tBxh .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-Ti3QvK9yUHW9tBxh .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-Ti3QvK9yUHW9tBxh .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-Ti3QvK9yUHW9tBxh .marker{fill:#333333;stroke:#333333;}#mermaid-svg-Ti3QvK9yUHW9tBxh .marker.cross{stroke:#333333;}#mermaid-svg-Ti3QvK9yUHW9tBxh svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-Ti3QvK9yUHW9tBxh p{margin:0;}#mermaid-svg-Ti3QvK9yUHW9tBxh .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-Ti3QvK9yUHW9tBxh .cluster-label text{fill:#333;}#mermaid-svg-Ti3QvK9yUHW9tBxh .cluster-label span{color:#333;}#mermaid-svg-Ti3QvK9yUHW9tBxh .cluster-label span p{background-color:transparent;}#mermaid-svg-Ti3QvK9yUHW9tBxh .label text,#mermaid-svg-Ti3QvK9yUHW9tBxh span{fill:#333;color:#333;}#mermaid-svg-Ti3QvK9yUHW9tBxh .node rect,#mermaid-svg-Ti3QvK9yUHW9tBxh .node circle,#mermaid-svg-Ti3QvK9yUHW9tBxh .node ellipse,#mermaid-svg-Ti3QvK9yUHW9tBxh .node polygon,#mermaid-svg-Ti3QvK9yUHW9tBxh .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-Ti3QvK9yUHW9tBxh .rough-node .label text,#mermaid-svg-Ti3QvK9yUHW9tBxh .node .label text,#mermaid-svg-Ti3QvK9yUHW9tBxh .image-shape .label,#mermaid-svg-Ti3QvK9yUHW9tBxh .icon-shape .label{text-anchor:middle;}#mermaid-svg-Ti3QvK9yUHW9tBxh .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-Ti3QvK9yUHW9tBxh .rough-node .label,#mermaid-svg-Ti3QvK9yUHW9tBxh .node .label,#mermaid-svg-Ti3QvK9yUHW9tBxh .image-shape .label,#mermaid-svg-Ti3QvK9yUHW9tBxh .icon-shape .label{text-align:center;}#mermaid-svg-Ti3QvK9yUHW9tBxh .node.clickable{cursor:pointer;}#mermaid-svg-Ti3QvK9yUHW9tBxh .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-Ti3QvK9yUHW9tBxh .arrowheadPath{fill:#333333;}#mermaid-svg-Ti3QvK9yUHW9tBxh .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-Ti3QvK9yUHW9tBxh .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-Ti3QvK9yUHW9tBxh .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-Ti3QvK9yUHW9tBxh .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-Ti3QvK9yUHW9tBxh .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-Ti3QvK9yUHW9tBxh .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-Ti3QvK9yUHW9tBxh .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-Ti3QvK9yUHW9tBxh .cluster text{fill:#333;}#mermaid-svg-Ti3QvK9yUHW9tBxh .cluster span{color:#333;}#mermaid-svg-Ti3QvK9yUHW9tBxh div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-Ti3QvK9yUHW9tBxh .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-Ti3QvK9yUHW9tBxh rect.text{fill:none;stroke-width:0;}#mermaid-svg-Ti3QvK9yUHW9tBxh .icon-shape,#mermaid-svg-Ti3QvK9yUHW9tBxh .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-Ti3QvK9yUHW9tBxh .icon-shape p,#mermaid-svg-Ti3QvK9yUHW9tBxh .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-Ti3QvK9yUHW9tBxh .icon-shape .label rect,#mermaid-svg-Ti3QvK9yUHW9tBxh .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-Ti3QvK9yUHW9tBxh .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-Ti3QvK9yUHW9tBxh .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-Ti3QvK9yUHW9tBxh :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 内部模块
外部依赖
FastAPI 框架
Pydantic 数据验证
Uvicorn ASGI 服务器
main.py
v1.py
add_text_style.py
add_text_style.py
logger.py
prepare.py & response.py

关键依赖关系

FastAPI 框架：提供 Web 服务框架和路由管理
Pydantic：用于数据验证和序列化
日志系统：统一的日志记录和格式化
中间件链：请求预处理和响应统一处理

性能考虑

时间复杂度分析

关键词解析：O(k)，其中 k 是关键词数量
位置查找：O(n*m)，其中 n 是文本长度，m 是关键词数量
颜色转换：O(1)
样式生成：O(n)

总体时间复杂度为 O(n*m + k)，空间复杂度为 O(n + m)。

优化建议

关键词排序：按长度降序排列，优先匹配长关键词
避免重复匹配 ：使用 used_positions 集合避免重叠匹配
内存管理：及时释放大对象引用
日志优化：在生产环境中适当降低日志级别

故障排除指南

常见错误及解决方案

错误码	错误信息	可能原因	解决方案
2026	无效的文本样式信息，请检查文本或关键词参数	参数格式错误或值无效	检查text和keyword参数格式
2027	文本样式创建失败	处理过程中发生异常	查看服务器日志，联系技术支持

调试技巧

启用详细日志：在开发环境中查看详细的执行日志
参数验证：确保所有必需参数都正确提供
字符编码：注意中文字符的正确编码处理
内存监控：监控长时间运行时的内存使用情况

文档信息

接口文档： docs.jcaigc.cn
效果案例： www.jcaigc.cn/workflow
开源仓库： capcut-mate