add_video_background_filling
Add background fill effects to video segments in JianYing/CapCut projects. Choose blur or color fills to enhance video backgrounds during editing.
Instructions
为视频片段添加背景填充效果
Args: video_segment_id: 视频片段ID，通过add_video_segment获得 fill_type: 填充类型，"blur"表示模糊，"color"表示颜色 blur: 模糊程度，范围0.0-1.0，仅在fill_type为"blur"时有效，默认0.0625 剪映中的四档模糊数值分别为0.0625, 0.375, 0.75和1.0 color: 填充颜色，格式为'#RRGGBBAA'，仅在fill_type为"color"时有效，默认"#00000000"
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| video_segment_id | Yes | ||
| fill_type | Yes | ||
| blur | No | ||
| color | No | #00000000 |
Implementation Reference
- jianyingdraft/tool/video_tool.py:444-502 (handler)MCP tool handler for add_video_background_filling: validates parameters, resolves draft/track info, and delegates to service layer.@mcp.tool() def add_video_background_filling( video_segment_id: str, fill_type: str, blur: float = 0.0625, color: str = "#00000000" ) -> ToolResponse: """ 为视频片段添加背景填充效果 Args: video_segment_id: 视频片段ID，通过add_video_segment获得 fill_type: 填充类型，"blur"表示模糊，"color"表示颜色 blur: 模糊程度，范围0.0-1.0，仅在fill_type为"blur"时有效，默认0.0625 剪映中的四档模糊数值分别为0.0625, 0.375, 0.75和1.0 color: 填充颜色，格式为'#RRGGBBAA'，仅在fill_type为"color"时有效，默认"#00000000" """ # 参数验证 if fill_type not in ["blur", "color"]: return ToolResponse( success=False, message=f"无效的填充类型 '{fill_type}'，支持的类型: blur, color" ) if not (0.0 <= blur <= 1.0): return ToolResponse( success=False, message=f"模糊程度必须在0.0-1.0范围内，当前值: {blur}" ) # 通过video_segment_id获取相关信息 draft_id = index_manager.get_draft_id_by_video_segment_id(video_segment_id) track_info = index_manager.get_track_info_by_video_segment_id(video_segment_id) if not draft_id: return ToolResponse( success=False, message=f"未找到视频片段ID对应的草稿: {video_segment_id}" ) if not track_info: return ToolResponse( success=False, message=f"未找到视频片段ID对应的轨道信息: {video_segment_id}" ) track_name = track_info.get("track_name") # 调用服务层处理业务逻辑 result = add_video_background_filling_service( draft_id=draft_id, video_segment_id=video_segment_id, fill_type=fill_type, blur=blur, color=color, track_name=track_name ) return result
- Service layer function that creates VideoSegment and calls add_background_filling method to implement the background filling logic.def add_video_background_filling_service( draft_id: str, video_segment_id: str, fill_type: str, blur: float = 0.0625, color: str = "#00000000", track_name: Optional[str] = None ) -> ToolResponse: """ 视频背景填充添加服务 - 为视频片段添加背景填充效果 Args: draft_id: 草稿ID video_segment_id: 视频片段ID fill_type: 填充类型，"blur"表示模糊，"color"表示颜色 blur: 模糊程度，0.0-1.0，仅在fill_type为"blur"时有效，默认0.0625 color: 填充颜色，格式为'#RRGGBBAA'，仅在fill_type为"color"时有效，默认"#00000000" track_name: 轨道名称（可选） Returns: ToolResponse: 包含操作结果的响应对象 """ try: # 创建VideoSegment实例，传入video_segment_id video_segment = VideoSegment(draft_id, video_segment_id=video_segment_id, track_name=track_name) # 调用视频背景填充添加方法 result_data = video_segment.add_background_filling( fill_type=fill_type, blur=blur, color=color ) # 构建返回数据 response_data = { "video_segment_id": video_segment_id, "draft_id": draft_id, "fill_type": fill_type, "blur": blur, "color": color, "add_background_filling": result_data } # 如果有轨道名称，添加到返回数据中 if track_name: response_data["track_name"] = track_name return ToolResponse( success=True, message=f"视频背景填充添加成功: {fill_type}", data=response_data ) except ValueError as e: # 处理参数错误 return ToolResponse( success=False, message=f"参数错误: {str(e)}" ) except NameError as e: # 处理轨道不存在错误 return ToolResponse( success=False, message=f"轨道错误: {str(e)}" ) except Exception as e: # 处理其他未预期的错误 return ToolResponse( success=False, message=f"视频背景填充添加失败: {str(e)}" )
- jianyingdraft/tool/video_tool.py:8-11 (registration)Import statement registering the service function for use in the tool handler.from jianyingdraft.services.video_service import add_video_segment_service, add_video_animation_service, \ add_video_transition_service, add_video_keyframe_service, add_video_filter_service, \ add_video_background_filling_service, \ add_video_mask_service, add_video_effect_service