1、增加调用 AI 视频生成能力和虚拟素材库管理的对外api

2、增加后台apikkey管理 3、增加apikey单独的模型定价 4、增加apikey调用情况 5、完善所有数据的注释增加
2026-08-06 13:13:28 +08:00
parent a55d4d649c
commit 0c511f3451
102 changed files with 13986 additions and 41 deletions
@@ -0,0 +1,106 @@
+from __future__ import annotations
+
+from datetime import datetime
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class VpV3AssetCreate(BaseModel):
+    """在项目下创建虚拟素材请求（一步到位：接收远程 URL 先下载到本地，再同步火山）。"""
+
+    source_url: str = Field(
+        ...,
+        min_length=8,
+        max_length=2000,
+        description=(
+            "素材源 URL（必须 http/https 公网可访问的图片/视频直链，"
+            "系统先将其下载保存到本地存储并占用存储配额，再同步到火山）"
+        ),
+    )
+    name: str | None = Field(
+        None, max_length=100, description="素材名称（可选；不传则自动从 URL 文件名 / Content-Disposition 推断）",
+    )
+    asset_type: str = Field(
+        ..., pattern=r"^(Image|Video)$", description="素材类型：Image=图片 / Video=视频",
+    )
+    video_duration: float | None = Field(
+        None, description="视频时长，秒（Video 可选；不传时系统自动用 ffprobe 探测；最大 60 秒）",
+    )
+    video_cover_url: str | None = Field(
+        None, description="视频封面图 URL（可选，仅 Video 用，建议 16:9）",
+    )
+
+
+class VpV3AssetOut(BaseModel):
+    """虚拟素材详情响应。"""
+
+    model_config = ConfigDict(extra="ignore")
+
+    asset_id: str = Field(description="素材 ID")
+    project_id: str = Field(description="所属项目 ID")
+    name: str | None = Field(None, description="素材名称")
+    asset_type: str = Field(description="素材类型：Image/Video")
+    status: str = Field(description="素材状态")
+
+    # 显示 URL
+    source_url: str = Field(description="原始上传 URL")
+    preview_url: str | None = Field(None, description="显示用预览 URL（可能带签名过期）")
+    remote_url: str | None = Field(None, description="火山返回的资源访问 URL（可能带签名过期）")
+    remote_url_expired_at: datetime | None = Field(None, description="remote_url 过期时间")
+
+    video_duration: float | None = Field(None, description="视频时长秒")
+    video_cover_url: str | None = Field(None, description="视频封面")
+    file_size_bytes: int | None = Field(None, description="文件大小字节")
+    mime_type: str | None = Field(None, description="MIME 类型")
+
+    moderation_json: dict | None = Field(None, description="火山审核 JSON（失败时可查看原因）")
+    error_message: str | None = Field(None, description="失败原因")
+    remote_delete_status: str = Field("none", description="远端删除状态")
+
+    created_at: datetime = Field(description="创建时间")
+    updated_at: datetime = Field(description="最后更新时间")
+
+
+class VpV3AssetListOut(BaseModel):
+    """虚拟素材列表响应。"""
+
+    items: list[VpV3AssetOut] = Field(default_factory=list)
+    total: int = Field(0, description="总数")
+    page: int = Field(1, description="当前页码")
+    page_size: int = Field(20, description="每页数量")
+
+
+class VpV3AssetDeleteOut(BaseModel):
+    """删除响应。"""
+
+    success: bool = Field(True)
+    remote_delete_status: str = Field(description="远端删除状态")
+
+
+class VpV3SelectableAssetOut(BaseModel):
+    """AI 创作选择器使用的素材条目。"""
+
+    model_config = ConfigDict(extra="ignore")
+
+    asset_id: str = Field(description="素材 ID（带入生成用 source=vp_v3_asset + asset_id）")
+    project_id: str = Field(description="项目 ID")
+    name: str | None = Field(None)
+    asset_type: str = Field(description="Image/Video")
+    status: str = Field(description="状态=Active")
+
+    source_url: str = Field(description="原始上传 URL")
+    preview_url: str | None = Field(None, description="预览 URL（直接显示用）")
+    video_duration: float | None = Field(None)
+    video_cover_url: str | None = Field(None)
+    file_size_bytes: int | None = Field(None)
+
+    created_at: datetime = Field(description="创建时间")
+
+
+class VpV3SelectableAssetListOut(BaseModel):
+    """AI 创作选择器素材列表。"""
+
+    items: list[VpV3SelectableAssetOut] = Field(default_factory=list)
+    total: int = Field(0)
+    page: int = Field(1)
+    page_size: int = Field(20)