videoSummary/openspec/changes/improve-dashscope-api-key-error-handling/proposal.md

变更：改进 DashScope API Key 错误处理

原因

当前实现中，当 DashScope API key 未设置时，会抛出 ValueError 异常，导致：

1. 服务器返回 500 内部错误，而不是更友好的 400 错误
2. 错误信息不够清晰，用户不知道如何配置
3. 前端无法正确显示错误提示

需要改进错误处理，提供更友好的错误响应和用户提示。

变更内容

• 在 AnalysisService 中捕获 ValueError 异常，返回友好的错误消息
• 在 API 路由中确保错误被正确转换为 JSON 响应
• 改进错误消息，明确指导用户如何配置 API key
• 确保所有 API 端点都返回一致的错误格式

影响

• 受影响的文件：
  • app/services/analysis_service.py - 改进错误处理
  • app/routes/video_routes.py - 确保错误正确返回
• 用户体验改进：更清晰的错误提示
• API 响应格式统一：所有错误都返回 JSON 格式