真人素材库修复相关BUG

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

@@ -56,6 +56,21 @@ class GenerationAIReference(BaseModel):
         description="后端回填的火山 Asset ID。前端传入时不可信，创建任务时以后端查库为准",
         examples=["asset-20260318071009-xxxxx"],
     )
+    provider_url: str | None = Field(
+        None,
+        description="供应商专用素材地址。真人素材生成时通常为 asset://remote_asset_id；仅用于后端排查和生成链路，不用于前端预览",
+        examples=["asset://asset-20260318071009-xxxxx"],
+    )
+    display_url: str | None = Field(
+        None,
+        description="前端展示用素材地址。真人素材历史响应会回填为可预览图片/视频/音频 URL",
+        examples=["/uploads/images/2026/07/06/demo.jpg"],
+    )
+    preview_url: str | None = Field(
+        None,
+        description="前端预览用素材地址；通常与 display_url 一致",
+        examples=["/uploads/images/2026/07/06/demo.jpg"],
+    )
 
 
 class GenerationAITaskCreate(BaseModel):

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

@@ -22,6 +22,7 @@ class PrivatePortraitAdminConfigUpdate(BaseModel):
 class PrivatePortraitProjectCreate(BaseModel):
     name: str = Field(..., min_length=1, max_length=128)
     description: str | None = Field(None, max_length=2000)
+    callback_redirect_url: str | None = Field(None, description="项目创建时真人认证完成后的手机端提示页地址")
 
 
 class PrivatePortraitProjectUpdate(BaseModel):
@@ -80,6 +81,14 @@ class PrivatePortraitValidateSessionOut(BaseModel):
     model_config = {"from_attributes": True}
 
 
+
+
+class PrivatePortraitProjectCreateWithValidateOut(BaseModel):
+    project: PrivatePortraitProjectOut
+    validate_session: PrivatePortraitValidateSessionOut
+    poll_interval_ms: int = Field(default=2000, description="PC 端轮询认证状态的建议间隔，单位毫秒")
+
+
 class PrivatePortraitAssetGroupOut(BaseModel):
     id: str
     user_id: str | None = None