import json from datetime import datetime from pydantic import BaseModel, Field, field_validator, model_validator class ConfirmGenerationRequest(BaseModel): """确认生成请求体 — 基于预览任务创建正式生成任务""" output_width: int = Field(default=1080, ge=100, description="输出视频宽度") output_height: int = Field(default=1920, ge=100, description="输出视频高度") cover_url: str = Field(default="", description="自定义封面图片 URL") custom_title: str = Field(default="", description="用户自定义标题文本,非空时同步到任务和编辑计划") class CreateGenerationTaskRequest(BaseModel): """创建生成任务请求。 支持两种模式(至少提供一种): - 项目模式:project_id + asset_library_id(向后兼容) - 模板模式:template_id + asset_ids / title_ids / voice_ids """ project_id: str = "" asset_library_id: str = "" strategy_id: str = "" voice_library_id: str = "" # ── 多变体独立配音(批量生成)── # 长度 1 = 所有变体共用;长度 = count = 每个变体独立配音;空数组 = 回退 voice_library_id voice_library_ids: list[str] = Field( default_factory=list, description="各变体独立配音素材库ID数组:长度1=共用,长度=count=独立。为空时回退 voice_library_id", ) created_by_user_id: str = "" # ── 模板模式新增字段 ── template_id: str = "" asset_ids: list[str] = Field(default_factory=list) title_ids: list[str] = Field(default_factory=list) voice_ids: list[str] = Field(default_factory=list) # ── 来源剪辑计划 ── source_edit_plan_id: str = "" # ── 标题配置(结构化)── title_config: dict | None = Field( default=None, description="标题样式对象,包含 text/font/font_size/font_color/position/bold/stroke/shadow 等。为空时不影响现有行为。", ) # ── 视频标题 ── video_title: str = Field(default="", description="生成视频的标题/名称,为空则使用默认命名") # ── 批量生成 ── count: int = Field(default=1, ge=1, le=50, description="批量生成数量,默认1,最大50") # ── 素材库自动匹配 ── asset_select_mode: str = Field( default="all", description="素材选取模式:all=全部ready视频, smart=智能匹配(按质量/时长评分)", ) asset_select_count: int = Field(default=0, ge=0, le=100, description="选取数量,0表示全部(仅 smart 模式有效)") # ── 自动重试 ── auto_retry_enabled: bool = Field( default=False, description="是否开启失败自动重试,默认关闭", ) auto_retry_max: int = Field( default=0, ge=0, le=5, description="最大自动重试次数,0表示不自动重试,最大5次", ) # ── 输出分辨率 ── resolution: str = Field( default="", description="输出分辨率,格式为 WIDTHxHEIGHT,如 1280x720、1080x1920。为空使用默认 1280x720", ) # ── 自定义 BGM ── bgm_config: dict = Field( default_factory=dict, description="自定义BGM配置,覆盖模板BGM设置。支持 enabled/source/asset_id/preset_id/audio_url/volume 等字段", ) # ── 预览 / 确认生成 ── is_preview: bool = Field(default=False, description="是否为预览任务") source_task_id: str = Field(default="", description="来源预览任务 ID(确认生成时传入)") output_width: int = Field(default=1280, description="输出视频宽度") output_height: int = Field(default=720, description="输出视频高度") cover_url: str = Field(default="", description="封面图片 URL") # ── 多变体独立封面(批量生成)── # 长度 1 = 所有变体共用;长度 = count = 每个变体独立封面;空数组 = 回退 cover_url cover_urls: list[str] = Field( default_factory=list, description="各变体独立封面URL数组:长度1=共用,长度=count=独立。为空时回退 cover_url", ) # ── 多变体独立标题文字(批量生成)── # 长度 1 = 所有变体共用;长度 = count = 每个变体独立标题文字;空数组 = 使用 title_config.text titles: list[str] = Field( default_factory=list, description="各变体独立标题文字数组:长度1=共用,长度=count=独立。为空时使用 title_config.text", ) @model_validator(mode="after") def _check_variant_arrays(self) -> "CreateGenerationTaskRequest": """变体数组字段长度校验:空数组(回退单值)、长度 1(共用)、或长度 = count(独立)。""" for name in ("voice_library_ids", "cover_urls", "titles"): arr = getattr(self, name) if arr and len(arr) != 1 and len(arr) != self.count: raise ValueError(f"{name} 长度必须为 1(共用)或 {self.count}(与 count 一致),当前为 {len(arr)}") return self @model_validator(mode="after") def _check_at_least_one_mode(self) -> "CreateGenerationTaskRequest": has_project = bool(self.project_id.strip()) has_template = bool(self.template_id.strip()) if not has_project and not has_template: raise ValueError("project_id 或 template_id 至少需要提供一个") has_library = bool(self.asset_library_id.strip()) has_assets = bool(self.asset_ids or self.title_ids or self.voice_ids) if not has_library and not has_assets: raise ValueError("asset_library_id 或 asset_ids/title_ids/voice_ids 至少需要提供一个") return self class GenerationTaskResponse(BaseModel): id: str project_id: str asset_library_id: str strategy_id: str voice_library_id: str template_id: str = "" asset_ids: list[str] = Field(default_factory=list) title_ids: list[str] = Field(default_factory=list) voice_ids: list[str] = Field(default_factory=list) source_edit_plan_id: str = "" asset_select_mode: str = "" batch_id: str = "" video_title: str = "" resolution: str = "" bgm_config: dict = Field(default_factory=dict) is_preview: bool = False source_task_id: str = "" output_width: int = 1280 output_height: int = 720 cover_url: str = "" title_config: dict = Field(default_factory=dict) status: str progress: float result_count: int error_message: str error_info: dict = Field(default_factory=dict) retry_count: int = 0 auto_retry_enabled: bool = False auto_retry_max: int = 0 logs: list[dict] = Field(default_factory=list) @field_validator("logs", mode="before") @classmethod def _parse_logs(cls, v: object) -> list[dict]: """将 JSON 字符串解析为 list[dict]。""" if isinstance(v, str): try: parsed = json.loads(v) return parsed if isinstance(parsed, list) else [] except (json.JSONDecodeError, TypeError): return [] if isinstance(v, list): return v return [] class BatchGenerationTaskResponse(BaseModel): """批量生成任务响应。""" items: list[GenerationTaskResponse] total: int class ListGenerationTasksResponse(BaseModel): """用户级生成任务列表响应(跨 project)。""" items: list[GenerationTaskResponse] # ── 预览生成(Phase 1) ─────────────────────────────────────────────────────── class CreatePreviewGenerationTaskRequest(BaseModel): """创建预览生成任务请求。 仅支持模板模式:template_id + asset_ids 等素材 ID 列表。 预览渲染品质与正式生成一致(1080p, CRF 23, medium preset)。 """ template_id: str asset_ids: list[str] = Field(default_factory=list) title_ids: list[str] = Field(default_factory=list) voice_ids: list[str] = Field(default_factory=list) voice_library_id: str = Field( default="", description="配音素材库ID(用户上传的音频或AI配音),对应配音选择页面选择的配音素材" ) video_title: str = Field(default="", description="生成视频的标题/名称,为空则使用默认命名") duration: float = Field(default=0.0, ge=0, description="期望视频时长(秒),0 表示由模板决定") video_ratio: str = Field(default="", description="视频比例,如 16:9 / 9:16,为空使用模板默认") bgm_config: dict = Field( default_factory=dict, description="自定义BGM配置,覆盖模板BGM设置。支持 enabled/source/asset_id/preset_id/audio_url/volume 等字段", ) preview_count: int = Field( default=1, ge=1, le=10, description="预览视频生成数量,范围 1-10,默认 1", ) source_edit_plan_id: str = Field( default="", description="关联的编辑计划ID(可选),用于确认生成时复用预览产物", ) title_config: dict = Field( default_factory=dict, description="标题配置(可选),渲染时烧录到预览视频中。支持字段: text/font/font_size/font_color/position/bold/stroke/shadow。N个变体时样式全局共用", ) # ── 多变体独立配置(preview_count > 1)── # 长度 1 = 所有变体共用;长度 = preview_count = 每个变体独立;空数组 = 回退单值字段 titles: list[str] = Field( default_factory=list, description="各变体独立标题文字数组:长度1=共用,长度=preview_count=独立。为空时使用 title_config.text", ) voice_library_ids: list[str] = Field( default_factory=list, description="各变体独立配音素材库ID数组:长度1=共用,长度=preview_count=独立。为空时回退 voice_library_id", ) cover_urls: list[str] = Field( default_factory=list, description="各变体独立封面URL数组:长度1=共用,长度=preview_count=独立(预览阶段通常为空)", ) @model_validator(mode="after") def _check_variant_arrays(self) -> "CreatePreviewGenerationTaskRequest": """变体数组字段长度校验:空数组(回退单值)、长度 1(共用)、或长度 = preview_count(独立)。""" for name in ("titles", "voice_library_ids", "cover_urls"): arr = getattr(self, name) if arr and len(arr) != 1 and len(arr) != self.preview_count: raise ValueError( f"{name} 长度必须为 1(共用)或 {self.preview_count}(与 preview_count 一致),当前为 {len(arr)}" ) return self @model_validator(mode="after") def _check_template_id(self) -> "CreatePreviewGenerationTaskRequest": if not self.template_id.strip(): raise ValueError("template_id 不能为空") return self @model_validator(mode="after") def _check_asset_ids(self) -> "CreatePreviewGenerationTaskRequest": if not self.asset_ids and not self.title_ids and not self.voice_ids: raise ValueError("asset_ids/title_ids/voice_ids 至少需要提供一个") return self class PreviewGenerationTaskResponse(BaseModel): """单个预览变体任务响应。 包含任务状态、进度、分辨率、生成结果 URL 等关键字段。 """ task_id: str status: str progress: float is_preview: bool = True variant_index: int = 0 resolution: str = "" video_url: str = "" duration: float = 0.0 file_size: int = 0 clip_count: int = 0 transition_count: int = 0 material_usage: dict = Field(default_factory=dict) error_message: str = "" title_text: str = "" voice_library_id: str = "" created_at: datetime | None = None started_at: datetime | None = None finished_at: datetime | None = None generate_duration: float = 0.0 class BatchPreviewGenerationTaskResponse(BaseModel): """批量预览任务响应:preview_count=N 时返回 N 个独立变体任务。 - items: 变体任务数组,按 variant_index 顺序排列,每个含独立 task_id/状态/预览视频URL - total: 变体总数(= preview_count) - 前端按 items[i].task_id 分别轮询 GET /preview/{task_id} 获取进度与结果 """ items: list[PreviewGenerationTaskResponse] total: int