fix(viral-video): #2122 三阶段 pipeline 补齐 voice_id/voice_source/video_ratio 字段

- domain/model/schema 新增 voice_id/voice_source/video_ratio 三个字段
- 幂等 ALTER TABLE 迁移补列（voice_id VARCHAR(200) / voice_source VARCHAR(20) / video_ratio VARCHAR(10)）
- POST /analyze-images 接收音色/比例参数，创建 job 时持久化
- POST /{id}/generate-copy 接收 voice_id/voice_source/video_ratio/style_guide，写回 job
- _step_tts 优先使用 job.voice_id，空则回退 job.persona_id，再空用默认 longxiaochun_v3
- _run_render_pipeline 调用 call_video_generation 时使用 job.video_ratio（默认 9:16）
- GET /{id} 返回 voice_id/voice_source/video_ratio
- 前端 TS types 同步补字段（AnalyzeImagesRequest/GenerateCopyRequest/ViralVideoJob）
- 新增 2 个单测验证字段持久化；viral 全量 95 个单测通过

apps/api/app/api/routes/viral_video.py

@@ -104,6 +104,9 @@ def _to_response(job) -> ViralVideoJobResponse:
         storyboard=getattr(job, "storyboard", None),
         generated_copy_text=getattr(job, "generated_copy_text", "") or "",
         copy_result=_build_copy_result(job),
+        voice_id=getattr(job, "voice_id", "") or "",
+        voice_source=getattr(job, "voice_source", "") or "",
+        video_ratio=getattr(job, "video_ratio", "9:16") or "9:16",
         intent_result=job.intent_result,
         result_video_url=job.result_video_url,
         credits_cost=job.credits_cost,
@@ -192,6 +195,9 @@ def analyze_images(
         reference_video_url=request.reference_video_url or "",
         style_template_id=request.style_template_id or "",
         style_strength=request.style_strength or "medium",
+        voice_id=request.voice_id or "",
+        voice_source=request.voice_source or "",
+        video_ratio=request.video_ratio or "9:16",
     )
     repo.save(job)
 
@@ -247,6 +253,11 @@ def generate_copy(
     job.reference_video_url = request.reference_video_url or job.reference_video_url
     job.style_strength = request.style_strength or job.style_strength
     job.style_template_id = request.style_template_id or job.style_template_id
+    if request.style_guide is not None:
+        job.style_guide = request.style_guide
+    job.voice_id = request.voice_id or job.voice_id
+    job.voice_source = request.voice_source or job.voice_source
+    job.video_ratio = request.video_ratio or job.video_ratio or "9:16"
 
     job.resume_from_image_analyzed()
     repo.update(job)

apps/api/app/schemas/viral_video.py

@@ -64,12 +64,16 @@ class CreateViralVideoRequest(BaseModel):
 
 
 class AnalyzeImagesRequest(BaseModel):
-    """v1.5 阶段1：创建任务并仅做图片/视频分析。images 必填，其他参数可选（阶段2再传）。"""
+    """v1.5 阶段1：创建任务并仅做图片/视频分析。images 必填，其他参数可选（阶段2再传/覆盖）。"""
 
     images: list[str] = Field(..., min_length=1, max_length=20)
     reference_video_url: str = Field(default="", description="参考爆款视频 URL（可选，有则同步做风格分析）")
     style_template_id: str = Field(default="", description="风格模板 ID（可选）")
     style_strength: str = Field(default="medium")
+    # v1.5.1 音色/视频参数（STEP1 已选定的音色可先传，阶段2可覆盖）
+    voice_id: str = Field(default="", description="TTS 音色 ID；空则用 persona_id 兜底")
+    voice_source: str = Field(default="", description="音色来源：preset/library/clone/upload")
+    video_ratio: str = Field(default="9:16", description="Seedance 视频比例：9:16/16:9/1:1 等")
 
 
 class GenerateCopyRequest(BaseModel):
@@ -77,7 +81,7 @@ class GenerateCopyRequest(BaseModel):
 
     industry: str = Field(default="")
     target_customer: str = Field(default="")
-    persona_id: str = Field(default="")
+    persona_id: str = Field(default="", description="人设 ID；voice_id 为空时也作为音色 ID 兜底")
     viral_structure: str = Field(default="")
     marketing_purpose: str = Field(default="")
     bgm_preference: str = Field(default="")
@@ -88,6 +92,11 @@ class GenerateCopyRequest(BaseModel):
     reference_video_url: str = Field(default="")
     style_strength: str = Field(default="medium")
     style_template_id: str = Field(default="")
+    style_guide: dict | None = Field(default=None)
+    # v1.5.1 音色/视频参数
+    voice_id: str = Field(default="", description="TTS 音色 ID（优先级高于 persona_id）")
+    voice_source: str = Field(default="", description="音色来源：preset/library/clone/upload")
+    video_ratio: str = Field(default="9:16", description="Seedance 视频比例")
 
     @field_validator("fusion_level")
     @classmethod
@@ -157,6 +166,10 @@ class ViralVideoJobResponse(BaseModel):
     generated_copy_text: str = ""
     # v1.5 前端 CopyResult 结构（final_copy/suggested_copy/title/scenes）
     copy_result: dict | None = None
+    # v1.5.1 音色/视频参数
+    voice_id: str = ""
+    voice_source: str = ""
+    video_ratio: str = "9:16"
     intent_result: dict | None = None
     result_video_url: str = ""
     credits_cost: int = 0