拆镜复刻片段重试切片API | 真人/虚拟素材库上传API

video-gen-api/app/schemas/shot_replicate.py

@@ -740,6 +740,27 @@ class ShotReanalyzeOut(BaseModel):
     analysis_status: str = Field(..., description="重置后的分析状态")
     celery_task_name: str = Field(..., description="已投递或待投递的 Celery 任务名")
 
+class ShotSplitRetryRequest(BaseModel):
+    force: bool = Field(False, description="是否强制重置；当前只用于兼容入参，已完成切片仍会拒绝重切，避免旧文件覆盖和资源释放复杂化")
+    reason: str | None = Field(None, max_length=200, description="切片失败重试原因，会写入模块日志")
+
+    @field_validator("reason", mode="before")
+    @classmethod
+    def _strip_reason(cls, value: str | None) -> str | None:
+        if value is None:
+            return None
+        value = str(value).strip()
+        return value or None
+
+
+class ShotSegmentSplitRetryOut(BaseModel):
+    message: str = Field(..., description="操作结果提示")
+    task_set_id: str = Field(..., description="拆镜总任务集ID")
+    segment_id: str = Field(..., description="拆镜片段ID")
+    split_status: str = Field(..., description="重置后的切片状态")
+    celery_task_name: str = Field(..., description="已投递或待投递的 Celery 任务名")
+
+
 class ShotSplitByAIOut(BaseModel):
     task_set_id: str = Field(..., description="拆镜总任务集ID")
     status: str = Field(..., description="总任务状态：pending_analysis/analyzing/analysis_completed/analysis_failed/splitting/split_completed/partial_failed/failed/deleted")