【剪映小助手】字幕信息生成接口（Caption Infos）
字幕信息生成接口
目录
- 简介
- 依赖关系
- 性能
- 故障排除
- 更多信息
简介
字幕信息生成接口：说明该接口在草稿自动化里的用途、依赖模块与常见报错。具体方法、路径、字段和校验请以OpenAPI为准。
依赖关系分析
组件依赖图
数据流依赖
性能考虑
内存使用优化
- 流式处理：字幕信息生成采用逐项处理的方式，避免一次性加载大量数据
- 内存复用：使用列表推导式和内置函数减少内存分配
- 字符串处理：使用高效的 JSON 序列化方法
并发处理能力
- 异步支持：基于 FastAPI 的异步特性，支持高并发请求
- 连接池：数据库连接和外部 API 调用使用连接池管理
- 缓存策略：对于重复的字幕信息可以考虑缓存机制
错误处理机制
- 参数验证：在服务层和路由层双重验证，确保数据完整性
- 异常捕获：统一的异常处理机制，防止服务崩溃
- 日志记录：详细的日志记录便于问题诊断和性能监控
故障排除指南
常见错误及解决方案
| 错误类型 | 错误代码 | 描述 | 解决方案 |
|---|---|---|---|
| 参数验证错误 | 400 | texts 和 timelines 长度不匹配 | 确保两个数组长度相同 |
| JSON 解析错误 | 400 | 请求体不是有效的 JSON | 检查 JSON 格式和语法 |
| 时间线无效 | 400 | start >= end 或负值 | 确保时间线参数有效 |
| 字体大小无效 | 400 | font_size <= 0 | 使用正整数作为字体大小 |
| 关键词参数不匹配 | 400 | keywords 长度与 texts 不匹配 | 确保关键词数量正确 |
调试技巧
- 启用详细日志：检查服务层的日志输出
- 参数验证：使用 Pydantic 的模型验证功能
- 单元测试：运行测试套件验证功能正确性
- API 文档：使用交互式 API 文档测试接口
更多信息
字段说明、校验规则与示例以 OpenAPI 为准；需要对照源码时请查看schemas/、service/与路由注册处。
文档信息
- 接口文档： docs.jcaigc.cn
- 效果案例： www.jcaigc.cn/workflow
- 开源仓库： capcut-mate