添加贴纸接口
目录
简介
添加贴纸接口：说明该接口在草稿自动化里的用途、依赖模块与常见报错。具体方法、路径、字段和校验请以 OpenAPI 为准。
依赖关系分析
系统依赖关系清晰，各模块职责明确：
#mermaid-svg-ypCITbblrEsiirtp{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-ypCITbblrEsiirtp .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-ypCITbblrEsiirtp .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-ypCITbblrEsiirtp .error-icon{fill:#552222;}#mermaid-svg-ypCITbblrEsiirtp .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-ypCITbblrEsiirtp .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-ypCITbblrEsiirtp .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-ypCITbblrEsiirtp .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-ypCITbblrEsiirtp .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-ypCITbblrEsiirtp .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-ypCITbblrEsiirtp .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-ypCITbblrEsiirtp .marker{fill:#333333;stroke:#333333;}#mermaid-svg-ypCITbblrEsiirtp .marker.cross{stroke:#333333;}#mermaid-svg-ypCITbblrEsiirtp svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-ypCITbblrEsiirtp p{margin:0;}#mermaid-svg-ypCITbblrEsiirtp .label{font-family:"trebuchet ms",verdana,arial,sans-serif;color:#333;}#mermaid-svg-ypCITbblrEsiirtp .cluster-label text{fill:#333;}#mermaid-svg-ypCITbblrEsiirtp .cluster-label span{color:#333;}#mermaid-svg-ypCITbblrEsiirtp .cluster-label span p{background-color:transparent;}#mermaid-svg-ypCITbblrEsiirtp .label text,#mermaid-svg-ypCITbblrEsiirtp span{fill:#333;color:#333;}#mermaid-svg-ypCITbblrEsiirtp .node rect,#mermaid-svg-ypCITbblrEsiirtp .node circle,#mermaid-svg-ypCITbblrEsiirtp .node ellipse,#mermaid-svg-ypCITbblrEsiirtp .node polygon,#mermaid-svg-ypCITbblrEsiirtp .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-ypCITbblrEsiirtp .rough-node .label text,#mermaid-svg-ypCITbblrEsiirtp .node .label text,#mermaid-svg-ypCITbblrEsiirtp .image-shape .label,#mermaid-svg-ypCITbblrEsiirtp .icon-shape .label{text-anchor:middle;}#mermaid-svg-ypCITbblrEsiirtp .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-ypCITbblrEsiirtp .rough-node .label,#mermaid-svg-ypCITbblrEsiirtp .node .label,#mermaid-svg-ypCITbblrEsiirtp .image-shape .label,#mermaid-svg-ypCITbblrEsiirtp .icon-shape .label{text-align:center;}#mermaid-svg-ypCITbblrEsiirtp .node.clickable{cursor:pointer;}#mermaid-svg-ypCITbblrEsiirtp .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-ypCITbblrEsiirtp .arrowheadPath{fill:#333333;}#mermaid-svg-ypCITbblrEsiirtp .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-ypCITbblrEsiirtp .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-ypCITbblrEsiirtp .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-ypCITbblrEsiirtp .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-ypCITbblrEsiirtp .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-ypCITbblrEsiirtp .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-ypCITbblrEsiirtp .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-ypCITbblrEsiirtp .cluster text{fill:#333;}#mermaid-svg-ypCITbblrEsiirtp .cluster span{color:#333;}#mermaid-svg-ypCITbblrEsiirtp 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-ypCITbblrEsiirtp .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-ypCITbblrEsiirtp rect.text{fill:none;stroke-width:0;}#mermaid-svg-ypCITbblrEsiirtp .icon-shape,#mermaid-svg-ypCITbblrEsiirtp .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-ypCITbblrEsiirtp .icon-shape p,#mermaid-svg-ypCITbblrEsiirtp .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-ypCITbblrEsiirtp .icon-shape .label rect,#mermaid-svg-ypCITbblrEsiirtp .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-ypCITbblrEsiirtp .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-ypCITbblrEsiirtp .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-ypCITbblrEsiirtp :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 配置文件
内部模块
外部依赖
FastAPI框架
数据验证
JSON处理
路由模块
服务模块
数据模型
工具模块
草稿引擎
配置文件
贴纸数据
性能考虑
系统在设计时充分考虑了性能优化：
缓存策略
- 草稿实例缓存：避免重复加载相同草稿
- 贴纸数据缓存：减少文件I/O操作
- 随机选择优化：预计算随机样本集合
内存管理
- 分页加载：限制单次返回的贴纸数量
- 懒加载：按需加载贴纸资源
- 及时清理：释放不再使用的资源
并发处理
- 异步操作：支持并发贴纸添加
- 连接池：复用数据库连接
- 资源限制：防止内存泄漏
故障排除指南
常见问题及解决方案
贴纸添加失败
问题症状 ：贴纸无法添加到草稿
可能原因：
- 草稿URL无效或过期
- 贴纸ID不存在
- 时间参数不正确
- 权限不足
解决步骤：
- 验证草稿URL的有效性
- 检查贴纸ID的正确性
- 确认时间参数的合理性
- 查看日志获取详细错误信息
贴纸搜索无结果
问题症状 ：搜索贴纸返回空结果
可能原因：
- 关键词不匹配任何贴纸
- 贴纸数据文件损坏
- 随机选择机制触发
解决步骤：
- 尝试不同的关键词
- 检查贴纸数据文件完整性
- 验证搜索算法正常运行
性能问题
问题症状 ：API响应缓慢
可能原因：
- 贴纸数据量过大
- 缓存未生效
- 系统资源不足
解决步骤：
- 实施分页加载
- 优化缓存策略
- 监控系统资源使用
更多信息
字段说明、校验规则与示例以 OpenAPI 为准；需要对照源码时请查看 schemas/、service/ 与路由注册处。
文档信息
- 接口文档： docs.jcaigc.cn
- 效果案例： www.jcaigc.cn/workflow
- 开源仓库： capcut-mate