利用 AI 大模型和自动化工作流,根据主题或关键词一键生成高清短视频。Generate HD short videos from a topic or keyword with an automated AI workflow.
Python ai-video-generatorcontent-creationffmpeginstagram-reelsllmpythonshort-videosubtitlestext-to-speechtiktokvideo-automationvideo-workflowworkflow-automationyoutube-shorts
feat(material): add native Seedance provider
harry0703eb8c23757e09
diff --git a/README-en.md b/README-en.mdindex d6fd6a44..d2488570 100644--- a/README-en.md+++ b/README-en.md@@ -140,6 +140,7 @@ Thanks to [Kimi](https://platform.kimi.ai?track_id=track-f6b0a640d35c41deb03b247- [x] Supports random or custom **background music** with adjustable volume- [x] Supports your own **local assets** and free-to-use HD footage from **Pexels**, **Pixabay**, and **Coverr**- [x] Supports **AI-generated footage**: [WaveSpeed AI](https://wavespeed.ai) text-to-video models (Seedance by default) create brand-new visuals from your script keywords instead of relying on stock libraries+- [x] Supports native **Volcano Engine Ark Seedance** text-to-video generation with configurable model/Endpoint ID, bounded polling, and paid-task confirmation- [x] Supports leading model providers including **Kimi / Moonshot AI**, **OpenAI**, **Anthropic Claude**, **Google Gemini**, **DeepSeek**, **Alibaba Cloud Qwen**, **Microsoft Azure OpenAI**, **ByteDance VolcEngine Ark**, **xAI Grok**, **MiniMax**, and **Xiaomi MiMo**, plus unified gateways, aggregators, and local runtimes such as **Cloudflare AI Gateway**, **Alibaba ModelScope**, **AIHubMix**, **AIML API**, **EvoLink**, **Ollama**, **OneAPI**, **LiteLLM**, **Groq**, and **Pollinations AI**- [x] Supports one-click **cross-platform publishing** to **TikTok**, **Instagram**, and **YouTube Shorts** after video generation- [x] Supports **exporting and importing generation settings** as a preset file, and backing up and restoring every **API key** from the settings dialog@@ -462,6 +463,24 @@ Restart the app after saving. Generated videos will then be published automatica</details>+<details>+<summary>How do I use the official Volcano Engine Ark Seedance provider?</summary>++Create an [Ark API key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey), then configure the provider under `[app]`:++```toml+[app]+volcengine_seedance_api_key = "your-ark-api-key"+volcengine_seedance_model = "doubao-seedance-1-0-pro-250528"+volcengine_seedance_base_url = "https://ark.cn-beijing.volces.com/api/v3"+```++When the dedicated config value is empty, `VOLCENGINE_ARK_API_KEY` is used, followed by the existing `volcengine_api_key` LLM setting. Select **Volcano Engine Seedance** as the video source and explicitly confirm paid generation before starting. CLI users must add `--confirm-seedance-charge`.++The first integration supports text-to-video only. Every submitted clip is a paid asynchronous Ark task; the app polls the same task ID, stops submitting after an unknown state, and downloads only enough clips to cover the voiceover.++</details>+<details><summary>RuntimeError: No ffmpeg exe could be found</summary>diff --git a/README-ja.md b/README-ja.mdindex 4095e05c..58d0001a 100644--- a/README-ja.md+++ b/README-ja.md@@ -138,6 +138,7 @@- [x] **字幕生成**に対応。フォント、位置、色、サイズ、縁取り、背景スタイルを設定できます- [x] ランダムまたはカスタムの **BGM** に対応し、音量も調整できます- [x] 手持ちの**ローカル素材**に加え、**Pexels**、**Pixabay**、**Coverr** の無料で使える高画質素材に対応+- [x] ネイティブの **Volcano Engine Ark Seedance** テキスト動画生成に対応し、モデル/Endpoint ID、制限付きポーリング、有料タスク確認を設定できます- [x] **Kimi / Moonshot AI**、**OpenAI**、**Google Gemini**、**DeepSeek**、**Alibaba Cloud Qwen**、**Microsoft Azure OpenAI**、**ByteDance VolcEngine Ark**、**xAI Grok**、**MiniMax**、**Xiaomi MiMo** といった主要なモデルプロバイダーに加え、**Cloudflare AI Gateway**、**Alibaba ModelScope**、**AIHubMix**、**AIML API**、**EvoLink**、**Ollama**、**OneAPI**、**LiteLLM**、**Groq**、**Pollinations AI** などの統合ゲートウェイ、アグリゲーター、ローカルランタイムに対応- [x] 動画生成後、**TikTok**、**Instagram**、**YouTube Shorts** へワンクリックで**クロスプラットフォーム投稿**が可能- [x] 生成設定をプリセットファイルとして**エクスポート/インポート**でき、設定画面から **API キー**のバックアップと復元も可能@@ -440,6 +441,24 @@ upload_post_youtube_privacy_status = "public"</details>+<details>+<summary>Volcano Engine Ark の公式 Seedance 素材ソースを使うには?</summary>++[Ark API キー](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey)を作成し、`[app]` に次を設定します:++```toml+[app]+volcengine_seedance_api_key = "your-ark-api-key"+volcengine_seedance_model = "doubao-seedance-1-0-pro-250528"+volcengine_seedance_base_url = "https://ark.cn-beijing.volces.com/api/v3"+```++Seedance 専用設定が空の場合は、`VOLCENGINE_ARK_API_KEY` 環境変数、既存の LLM 用 `volcengine_api_key` 設定の順に使用します。動画ソースで **Volcano Engine Seedance** を選び、生成前に有料タスクを明示的に確認してください。CLI では `--confirm-seedance-charge` も必要です。++初期実装はテキスト動画生成のみです。各クリップは有料の非同期 Ark タスクとして送信され、同じタスク ID だけをポーリングします。状態が不明な場合は追加送信を停止し、ナレーションを満たす分だけ生成します。++</details>+<details><summary>RuntimeError: No ffmpeg exe could be found</summary>diff --git a/README.md b/README.mdindex d85db588..ccd6fba9 100644--- a/README.md+++ b/README.md@@ -150,6 +150,7 @@- [x] 支持 **背景音乐**,可随机选择或使用指定音乐,并调整音量- [x] 支持使用自己的 **本地素材**,也可从 **Pexels**、**Pixabay** 和 **Coverr** 获取可免费使用的高清素材- [x] 支持 **AI 生成素材**:接入 [WaveSpeed AI](https://wavespeed.ai) 文生视频模型(默认 Seedance),按脚本关键词直接生成全新画面,不再受限于库存素材+- [x] 原生支持 **火山引擎方舟 Seedance** 文生视频,可配置模型或推理接入点 ID,并提供有限轮询与付费任务确认- [x] 支持 **Kimi / Moonshot AI**、**OpenAI**、**Anthropic Claude**、**Google Gemini**、**DeepSeek**、**阿里云通义千问**、**Microsoft Azure OpenAI**、**火山引擎方舟**、**xAI Grok**、**MiniMax**、**小米 MiMo** 等主流模型服务,并兼容 **Cloudflare AI Gateway**、**魔搭 ModelScope**、**AIHubMix**、**AIML API**、**EvoLink**、**Ollama**、**OneAPI**、**LiteLLM**、**Groq**、**Pollinations AI** 等统一网关、聚合平台和本地运行环境- [x] 支持一键 **跨平台发布**,生成完成后可自动上传至 **TikTok**、**Instagram** 和 **YouTube Shorts**- [x] 支持将生成设置**导出和导入**为预设文件,并在设置弹窗中备份和恢复所有 **API Key**@@ -457,6 +458,24 @@ upload_post_youtube_privacy_status = "public"</details>+<details>+<summary>如何使用火山引擎方舟官方 Seedance 素材源?</summary>++创建[火山方舟 API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey),然后在 `[app]` 下配置:++```toml+[app]+volcengine_seedance_api_key = "your-ark-api-key"+volcengine_seedance_model = "doubao-seedance-1-0-pro-250528"+volcengine_seedance_base_url = "https://ark.cn-beijing.volces.com/api/v3"+```++Seedance 专用配置为空时,会依次使用 `VOLCENGINE_ARK_API_KEY` 环境变量和已有的 `volcengine_api_key` 大模型配置。在视频源中选择“火山引擎 Seedance”,并在生成前明确确认付费任务;CLI 还需要传入 `--confirm-seedance-charge`。++首版仅支持文生视频。每个片段都会创建一个异步付费方舟任务;程序只轮询同一个任务 ID,状态不明时停止继续下单,并仅生成足够覆盖配音时长的素材。++</details>+<details><summary>RuntimeError: No ffmpeg exe could be found</summary>diff --git a/app/services/material.py b/app/services/material.pyindex 0df26ebb..16b2302c 100644--- a/app/services/material.py+++ b/app/services/material.py@@ -1,3 +1,4 @@+import mathimport osimport randomimport threading@@ -12,7 +13,7 @@ from moviepy.video.io.VideoFileClip import VideoFileClipfrom app.config import configfrom app.models.schema import MaterialInfo, VideoAspect, VideoConcatMode-from app.services import material_cache, task_artifacts+from app.services import material_cache, task_artifacts, volcengine_seedancefrom app.utils import utils# Thread-safe counter for API key rotation@@ -950,7 +951,9 @@ def _wait_for_wavespeed_prediction(time.sleep(WAVESPEED_POLL_INTERVAL_SECONDS)-def _save_wavespeed_video_with_retry(video_url: str, save_dir: str) -> str:+def _save_generated_video_with_retry(+ video_url: str, save_dir: str, provider: str+) -> str:"""下载已经付费生成的产物,失败时优先重试同一个地址。@@ -973,13 +976,15 @@ def _save_wavespeed_video_with_retry(video_url: str, save_dir: str) -> str:delay = WAVESPEED_RETRY_BASE_SECONDS * (attempt + 1)logger.warning("failed to download generated video, retry the same url: "+ f"provider={provider}, "f"attempt={attempt + 1}/{WAVESPEED_MAX_DOWNLOAD_RETRIES}, "f"{failure_detail}, retry_in={delay:.1f}s")time.sleep(delay)logger.error("failed to download generated video after "- f"{WAVESPEED_MAX_DOWNLOAD_RETRIES + 1} attempts: {failure_detail}"+ f"{WAVESPEED_MAX_DOWNLOAD_RETRIES + 1} attempts: "+ f"provider={provider}, {failure_detail}")return ""@@ -1188,6 +1193,17 @@ def download_videos(max_clip_duration=max_clip_duration,material_directory=material_directory,)+ if source == "volcengine_seedance":+ # 与 WaveSpeed 相同,方舟官方接口会创建异步付费任务。必须按需逐段+ # 生成,只购买当前配音时长真正需要的素材。+ return _download_videos_seedance_on_demand(+ task_id=task_id,+ search_terms=search_terms,+ video_aspect=video_aspect,+ audio_duration=audio_duration,+ max_clip_duration=max_clip_duration,+ material_directory=material_directory,+ )if match_script_order:return _download_videos_by_script_order(@@ -1309,8 +1325,8 @@ def _download_videos_wavespeed_on_demand()breakfor item in video_items:- saved_video_path = _save_wavespeed_video_with_retry(- item.url, material_directory+ saved_video_path = _save_generated_video_with_retry(+ item.url, material_directory, "wavespeed")if not saved_video_path:continue@@ -1343,6 +1359,119 @@ def _download_videos_wavespeed_on_demand(return video_paths+def _download_videos_seedance_on_demand(+ *,+ task_id: str,+ search_terms: List[str],+ video_aspect: VideoAspect,+ audio_duration: float,+ max_clip_duration: int,+ material_directory: str,+) -> List[str]:+ """顺序生成方舟 Seedance 素材,覆盖配音时长后立即停止付费下单。"""+ video_paths: List[str] = []+ material_sources: list[dict[str, Any]] = []++ # 付费生成循环必须先验证控制循环次数的两个时长。NaN/Infinity 会让+ # ``total_duration >= audio_duration`` 永远不成立,而非正片段时长会让+ # 累计值无法增长,两者都可能为全部关键词创建无用的付费任务。+ try:+ required_duration = float(audio_duration)+ except (TypeError, ValueError) as exc:+ raise volcengine_seedance.VolcEngineSeedanceError(+ "Seedance audio duration must be a finite number"+ ) from exc+ if not math.isfinite(required_duration):+ raise volcengine_seedance.VolcEngineSeedanceError(+ "Seedance audio duration must be a finite number"+ )+ if required_duration <= 0:+ logger.warning(+ "skip Seedance paid generation because required audio duration is "+ f"not positive: duration={required_duration}"+ )+ _persist_material_sources(task_id, material_sources)+ return video_paths++ try:+ clip_duration = int(max_clip_duration)+ except (TypeError, ValueError, OverflowError) as exc:+ raise volcengine_seedance.VolcEngineSeedanceError(+ "Seedance clip duration must be a positive integer"+ ) from exc+ if clip_duration <= 0:+ raise volcengine_seedance.VolcEngineSeedanceError(+ "Seedance clip duration must be a positive integer"+ )++ total_duration = 0.0+ for search_term in search_terms:+ try:+ video_items = volcengine_seedance.generate_videos(+ search_term=search_term,+ minimum_duration=clip_duration,+ video_aspect=video_aspect,+ )+ except volcengine_seedance.VolcEngineSeedanceUnconfirmedTaskError as exc:+ # 远端付费任务仍可能成功。立即停止继续下单,并保留任务 ID,方便+ # 用户随后在方舟控制台确认或找回结果。+ logger.error(+ "stop submitting new Seedance tasks because the last paid task "+ f"is unconfirmed: task_id={exc.task_id or 'unknown'}, detail={exc}"+ )+ _persist_material_sources(task_id, material_sources)+ raise+ except volcengine_seedance.VolcEngineSeedanceError as exc:+ logger.error(f"Seedance generation failed before completion: {exc}")+ _persist_material_sources(task_id, material_sources)+ raise++ for item in video_items:+ saved_video_path = _save_generated_video_with_retry(+ item.url, material_directory, "volcengine_seedance"+ )+ if not saved_video_path:+ # 远端任务已完成并产生费用,本地下载失败时必须把远端任务 ID+ # 带回任务状态,便于用户去方舟控制台找回结果。这里直接抛出+ # 专用错误,同时阻止后续关键词继续创建新的付费任务。+ source_info = (+ item.source_info if isinstance(item.source_info, dict) else {}+ )+ remote_task_id = str(source_info.get("asset_id") or "").strip()+ _persist_material_sources(task_id, material_sources)+ raise volcengine_seedance.VolcEngineSeedanceDownloadError(+ "Seedance generated a paid video but the result could not be "+ f"downloaded: id={remote_task_id or 'unknown'}",+ task_id=remote_task_id,+ )+ logger.info(f"video saved: {saved_video_path}")+ video_paths.append(saved_video_path)+ try:+ material_sources.append(_material_source_record(item, saved_video_path))+ except Exception as source_error:+ logger.warning(+ "failed to prepare generated material source record: "+ f"provider=volcengine_seedance, "+ f"error={type(source_error).__name__}, detail={source_error}"+ )+ total_duration += min(clip_duration, item.duration)+ if total_duration >= required_duration:+ break+ if total_duration >= required_duration:+ logger.info(+ "generated Seedance materials cover the required duration; stop "+ f"submitting paid tasks: generated={total_duration:.1f}s, "+ f"required={required_duration:.1f}s"+ )+ break++ logger.success(+ f"generated and downloaded {len(video_paths)} Volcano Engine Seedance videos"+ )+ _persist_material_sources(task_id, material_sources)+ return video_paths++def _download_videos_by_script_order(task_id: str,search_terms: List[str],diff --git a/app/services/task.py b/app/services/task.pyindex 0197f391..16b91f54 100644--- a/app/services/task.py+++ b/app/services/task.py@@ -25,6 +25,7 @@ from app.services import (task_artifacts,twelvelabs,video,+ volcengine_seedance,voice,)from app.services import upload_post@@ -706,20 +707,38 @@ def get_video_materials(logger.info(f"\n\n## downloading videos from {params.video_source}")# 顺序匹配模式只在用户显式开启时生效。这里强制素材下载按关键词顺序# 轮询,避免某个早期关键词下载太多素材,把后续脚本主题挤出最终时间线。- downloaded_videos = material.download_videos(- task_id=task_id,- search_terms=video_terms,- source=params.video_source,- video_aspect=params.video_aspect,- video_concat_mode=(- VideoConcatMode.sequential- if params.match_materials_to_script- else params.video_concat_mode- ),- audio_duration=audio_duration * params.video_count,- max_clip_duration=params.video_clip_duration,- match_script_order=params.match_materials_to_script,- )+ try:+ downloaded_videos = material.download_videos(+ task_id=task_id,+ search_terms=video_terms,+ source=params.video_source,+ video_aspect=params.video_aspect,+ video_concat_mode=(+ VideoConcatMode.sequential+ if params.match_materials_to_script+ else params.video_concat_mode+ ),+ audio_duration=audio_duration * params.video_count,+ max_clip_duration=params.video_clip_duration,+ match_script_order=params.match_materials_to_script,+ )+ except volcengine_seedance.VolcEngineSeedanceError as exc:+ # 未确认状态和已生成但下载失败都对应一个可在方舟控制台恢复的远端+ # 任务。统一从异常携带的 task_id 写入失败状态,避免不同异常分支+ # 各自维护恢复信息并在后续扩展时再次遗漏。+ remote_task_id = str(getattr(exc, "task_id", "") or "").strip()+ details = (+ {"volcengine_seedance_task_id": remote_task_id}+ if remote_task_id+ else None+ )+ _mark_task_failed(+ task_id,+ "materials",+ str(exc),+ details=details,+ )+ return Noneif not downloaded_videos:_mark_task_failed(task_id,@@ -1231,6 +1250,17 @@ def _run_pipeline(logger.info(f"start task: {task_id}, stop_at: {stop_at}")sm.state.update_task(task_id, state=const.TASK_STATE_PROCESSING, progress=5)+ if (+ stop_at in {"materials", "video"}+ and params.video_source == "volcengine_seedance"+ and not volcengine_seedance.is_enabled()+ ):+ return _mark_task_failed(+ task_id,+ "preflight",+ "Volcano Engine Seedance requires an Ark API key",+ )+# 只有完整成片流程需要视频配乐供应商。尽早阻止缺少 Key 的完整任务,避免# 先消耗 LLM、TTS 和素材服务额度;中间产物接口仍可独立使用。video_music_provider = _VIDEO_MUSIC_PROVIDERS.get(params.bgm_type)diff --git a/app/services/volcengine_seedance.py b/app/services/volcengine_seedance.pynew file mode 100644index 00000000..9566550d--- /dev/null+++ b/app/services/volcengine_seedance.py@@ -0,0 +1,441 @@+import math+import os+import time+from typing import Any, Mapping+from urllib.parse import quote_plus++import requests+from loguru import logger++from app.config import config+from app.models.schema import MaterialInfo, VideoAspect+++DEFAULT_BASE_URL = "https://ark.cn-beijing.volces.com/api/v3"+DEFAULT_MODEL_ID = "doubao-seedance-1-0-pro-250528"+DEFAULT_RESOLUTION = "1080p"+DEFAULT_MIN_DURATION_SECONDS = 2+DEFAULT_MAX_DURATION_SECONDS = 12+DEFAULT_POLL_INTERVAL_SECONDS = 5.0+DEFAULT_RUN_TIMEOUT_SECONDS = 1800.0+MAX_POLL_RETRIES = 5+RETRY_BASE_SECONDS = 1.0+MAX_ERROR_TEXT_LENGTH = 500+RETRYABLE_STATUS_CODES = frozenset({429, 500, 502, 503, 504})+TERMINAL_FAILURE_STATUSES = frozenset(+ {"failed", "cancelled", "canceled", "expired"}+)+ACTIVE_STATUSES = frozenset({"queued", "running"})+SUPPORTED_RESOLUTIONS = frozenset({"480p", "720p", "1080p"})+++class VolcEngineSeedanceError(RuntimeError):+ """确定性的配置、请求或响应错误。"""++ def __init__(self, message: str, task_id: str = ""):+ super().__init__(message)+ # 只要远端任务已经创建,所有错误类型都统一携带任务 ID。上层无需+ # 根据异常子类分别维护恢复逻辑,WebUI/API 也能稳定展示排障依据。+ self.task_id = task_id+++class VolcEngineSeedanceUnconfirmedTaskError(VolcEngineSeedanceError):+ """远端可能已创建付费任务,但本机无法确认其最终状态。"""++ def __init__(self, message: str, task_id: str = ""):+ super().__init__(message, task_id=task_id)+++class VolcEngineSeedanceDownloadError(VolcEngineSeedanceError):+ """远端付费任务已成功,但生成的视频未能下载到本机。"""++ def __init__(self, message: str, task_id: str):+ super().__init__(message, task_id=task_id)+++def get_api_key(settings: Mapping[str, Any] | None = None) -> str:+ """+ 按明确且唯一的优先级读取方舟凭据。++ Seedance 专用配置优先级最高;唯一支持的运行时环境变量是语义明确的+ ``VOLCENGINE_ARK_API_KEY``。历史 ``volcengine_api_key`` 只作为共享配置+ 兜底,避免已经接入方舟大模型的用户升级后必须重复填写同一把 Key。+ """+ settings = config.app if settings is None else settings+ configured = str(settings.get("volcengine_seedance_api_key", "") or "").strip()+ environment_key = os.getenv("VOLCENGINE_ARK_API_KEY", "").strip()+ shared_ark_key = str(settings.get("volcengine_api_key", "") or "").strip()+ return configured or environment_key or shared_ark_key+++def is_enabled(settings: Mapping[str, Any] | None = None) -> bool:+ return bool(get_api_key(settings))+++def _base_url() -> str:+ return str(+ config.app.get("volcengine_seedance_base_url", DEFAULT_BASE_URL)+ or DEFAULT_BASE_URL+ ).rstrip("/")+++def _model_id() -> str:+ return str(+ config.app.get("volcengine_seedance_model", DEFAULT_MODEL_ID)+ or DEFAULT_MODEL_ID+ ).strip()+++def _resolution() -> str:+ configured = config.app.get("volcengine_seedance_resolution", DEFAULT_RESOLUTION)+ value = str(configured).strip().lower()+ if value not in SUPPORTED_RESOLUTIONS:+ # 分辨率会直接影响付费任务的规格。无效值不能静默回退到最高默认+ # 分辨率。配置项缺失时由 get 使用默认值;一旦用户显式写入空值、+ # None、0 等非法值也必须报错,否则仍可能产生超出预期的费用。+ supported = ", ".join(sorted(SUPPORTED_RESOLUTIONS))+ raise VolcEngineSeedanceError(+ f"Unsupported Seedance resolution {value!r}; expected one of: {supported}"+ )+ return value+++def _config_bool(key: str, default: bool) -> bool:+ value = config.app.get(key, default)+ if isinstance(value, str):+ return value.strip().lower() not in {"0", "false", "no", "off", ""}+ return bool(value)+++def _bounded_float(key: str, default: float, minimum: float, maximum: float) -> float:+ try:+ value = float(config.app.get(key, default))+ except (TypeError, ValueError):+ return default+ if not math.isfinite(value):+ return default+ return min(max(value, minimum), maximum)+++def _duration_bounds() -> tuple[int, int]:+ def read(key: str, default: int) -> int:+ try:+ value = int(config.app.get(key, default))+ except (TypeError, ValueError):+ return default+ return value if value >= 1 else default++ minimum = read(+ "volcengine_seedance_min_duration", DEFAULT_MIN_DURATION_SECONDS+ )+ maximum = read(+ "volcengine_seedance_max_duration", DEFAULT_MAX_DURATION_SECONDS+ )+ return minimum, max(minimum, maximum)+++def _tls_verify() -> bool:+ return _config_bool("tls_verify", True)+++def _status_code(response: Any) -> int:+ try:+ return int(getattr(response, "status_code", 200))+ except (TypeError, ValueError):+ return 200+++def _redact_secret(value: Any, secret: str) -> str:+ text = str(value or "")+ if secret:+ text = text.replace(secret, "***")+ encoded = quote_plus(secret)+ if encoded != secret:+ text = text.replace(encoded, "***")+ for proxy_url in config.proxy.values():+ proxy_secret = str(proxy_url or "")+ if proxy_secret:+ text = text.replace(proxy_secret, "***")+ return text[:MAX_ERROR_TEXT_LENGTH]+++def _response_error(response: Any, api_key: str) -> str:+ try:+ payload = response.json()+ except Exception:+ return f"HTTP {_status_code(response)}"+ if not isinstance(payload, dict):+ return f"HTTP {_status_code(response)}"+ error = payload.get("error")+ if isinstance(error, dict):+ code = error.get("code") or payload.get("code")+ message = error.get("message") or payload.get("message")+ else:+ code = payload.get("code")+ message = payload.get("message") or error+ detail = ": ".join(str(item) for item in (code, message) if item not in (None, ""))+ return _redact_secret(detail or f"HTTP {_status_code(response)}", api_key)+++def _is_retryable_error(error: Exception) -> bool:+ if isinstance(+ error,+ (+ requests.exceptions.ConnectionError,+ requests.exceptions.Timeout,+ requests.exceptions.ChunkedEncodingError,+ ),+ ):+ return True+ response = getattr(error, "response", None)+ return response is not None and _status_code(response) in RETRYABLE_STATUS_CODES+++def _rendition_size(aspect: VideoAspect, resolution: str) -> tuple[int, int]:+ # 方舟的 480p 视频长边按编码对齐实际输出为 864,而不是数学换算得到的+ # 854;720p 和 1080p 分别按官方比例输出 1280、1920。本机真实调用已+ # 验证 480p 竖屏产物为 480x864。来源记录必须描述真实产物,否则后续+ # 审计或素材诊断会看到与文件不一致的尺寸。+ short_edge = {"480p": 480, "720p": 720, "1080p": 1080}[resolution]+ long_edge = {"480p": 864, "720p": 1280, "1080p": 1920}[resolution]+ if aspect == VideoAspect.portrait:+ return short_edge, long_edge+ if aspect == VideoAspect.square:+ return short_edge, short_edge+ return long_edge, short_edge+++def generate_videos(+ search_term: str,+ minimum_duration: int,+ video_aspect: VideoAspect = VideoAspect.portrait,+) -> list[MaterialInfo]:+ """提交一个方舟 Seedance 文生视频任务,并等待可下载的结果地址。"""+ api_key = get_api_key()+ if not api_key:+ raise VolcEngineSeedanceError(+ "Volcano Engine Seedance requires an Ark API key"+ )++ term = str(search_term or "").strip()+ if not term:+ # 空提示词可能来自上游脚本拆分异常。付费生成源不能把它提交到远端,+ # 否则即使接口接受请求,也只会得到无法使用且已经计费的视频。+ raise VolcEngineSeedanceError("Seedance search term must not be empty")++ aspect = VideoAspect(video_aspect)+ requested_duration = max(int(minimum_duration), 1)+ minimum, maximum = _duration_bounds()+ duration = min(max(requested_duration, minimum), maximum)+ resolution = _resolution()+ payload = {+ "model": _model_id(),+ "content": [{"type": "text", "text": term}],+ "ratio": aspect.value,+ "duration": duration,+ "resolution": resolution,+ "watermark": _config_bool("volcengine_seedance_watermark", False),+ }+ headers = {+ "Authorization": f"Bearer {api_key}",+ "Content-Type": "application/json",+ }+ tasks_url = f"{_base_url()}/contents/generations/tasks"+ logger.info(+ "generating video with Volcano Engine Seedance: "+ f"model={payload['model']}, term={term!r}, duration={duration}s"+ )++ # 提交接口不做自动重试:超时或 5xx 可能发生在付费任务已经创建之后,+ # 盲目重试会造成重复扣费。只有拿到明确拒绝响应时才判定为确定性失败。+ try:+ response = requests.post(+ tasks_url,+ json=payload,+ headers=headers,+ proxies=config.proxy,+ verify=_tls_verify(),+ timeout=(30, 60),+ )+ except Exception as exc:+ raise VolcEngineSeedanceUnconfirmedTaskError(+ "Seedance submission returned no response; a paid task may already "+ "exist remotely: "+ f"error={type(exc).__name__}, detail={_redact_secret(exc, api_key)}"+ ) from exc++ status_code = _status_code(response)+ if status_code >= 500:+ raise VolcEngineSeedanceUnconfirmedTaskError(+ f"Seedance submission failed with HTTP {status_code}; a paid task may "+ "already exist remotely"+ )+ if not 200 <= status_code < 300:+ raise VolcEngineSeedanceError(+ "Seedance video generation request rejected: "+ f"HTTP {status_code}, {_response_error(response, api_key)}"+ )+ try:+ body = response.json()+ except Exception as exc:+ raise VolcEngineSeedanceUnconfirmedTaskError(+ "Seedance submission returned an unreadable response; a paid task may "+ f"already exist remotely: error={type(exc).__name__}"+ ) from exc+ task_id = str(body.get("id") or "").strip() if isinstance(body, dict) else ""+ if not task_id:+ raise VolcEngineSeedanceUnconfirmedTaskError(+ "Seedance accepted the submission without returning a task id"+ )+ logger.info(f"Volcano Engine Seedance task created: id={task_id}")++ task = _wait_for_task(+ task_id=task_id,+ tasks_url=tasks_url,+ headers=headers,+ api_key=api_key,+ )+ if task is None:+ return []+ content = task.get("content")+ video_url = content.get("video_url") if isinstance(content, dict) else None+ if not isinstance(video_url, str) or not video_url.startswith(("http://", "https://")):+ raise VolcEngineSeedanceError(+ f"Seedance task succeeded without a downloadable video: id={task_id}",+ task_id=task_id,+ )++ width, height = _rendition_size(aspect, resolution)+ return [+ MaterialInfo(+ provider="volcengine_seedance",+ url=video_url,+ duration=duration,+ source_info={+ "provider": "volcengine_seedance",+ "search_term": term,+ "asset_id": task_id,+ "rendition": {+ "id": task_id,+ "width": width,+ "height": height,+ },+ },+ )+ ]+++def _wait_for_task(+ *,+ task_id: str,+ tasks_url: str,+ headers: dict[str, str],+ api_key: str,+) -> dict[str, Any] | None:+ deadline = time.monotonic() + _bounded_float(+ "volcengine_seedance_run_timeout",+ DEFAULT_RUN_TIMEOUT_SECONDS,+ 60.0,+ 7200.0,+ )+ poll_interval = _bounded_float(+ "volcengine_seedance_poll_interval",+ DEFAULT_POLL_INTERVAL_SECONDS,+ 0.5,+ 60.0,+ )+ consecutive_failures = 0+ while True:+ remaining = deadline - time.monotonic()+ if remaining <= 0:+ raise VolcEngineSeedanceUnconfirmedTaskError(+ "Seedance task is still running after the configured local wait "+ f"timeout: id={task_id}",+ task_id=task_id,+ )++ # requests 的 connect/read timeout 分别计时,因此各使用剩余总时间的+ # 一半。即使连接和读取都走到上限,单轮请求也不会有意超过总截止时间;+ # 网络库仍可能有极小调度误差,下一处 deadline 检查会阻止再次重试。+ phase_timeout = max(min(remaining / 2.0, 30.0), 0.001)+ try:+ response = requests.get(+ f"{tasks_url}/{task_id}",+ headers=headers,+ proxies=config.proxy,+ verify=_tls_verify(),+ timeout=(phase_timeout, phase_timeout),+ )+ status_code = _status_code(response)+ if status_code in RETRYABLE_STATUS_CODES:+ raise requests.exceptions.HTTPError(+ f"HTTP {status_code}", response=response+ )+ if not 200 <= status_code < 300:+ raise VolcEngineSeedanceUnconfirmedTaskError(+ "Seedance task status is unknown: "+ f"http_status={status_code}, detail={_response_error(response, api_key)}",+ task_id=task_id,+ )+ body = response.json()+ if not isinstance(body, dict):+ raise VolcEngineSeedanceUnconfirmedTaskError(+ "Seedance task status response is malformed", task_id=task_id+ )+ except VolcEngineSeedanceUnconfirmedTaskError:+ raise+ except Exception as exc:+ if not _is_retryable_error(exc):+ raise VolcEngineSeedanceUnconfirmedTaskError(+ "Seedance polling failed and the paid task state is unknown: "+ f"error={type(exc).__name__}, detail={_redact_secret(exc, api_key)}",+ task_id=task_id,+ ) from exc++ remaining = deadline - time.monotonic()+ if remaining <= 0:+ raise VolcEngineSeedanceUnconfirmedTaskError(+ "Seedance task is still running after the configured local wait "+ f"timeout: id={task_id}",+ task_id=task_id,+ ) from exc+ consecutive_failures += 1+ if consecutive_failures > MAX_POLL_RETRIES:+ raise VolcEngineSeedanceUnconfirmedTaskError(+ "Seedance polling failed after retries; the paid task may still "+ f"be running remotely: id={task_id}",+ task_id=task_id,+ ) from exc+ delay = min(RETRY_BASE_SECONDS * consecutive_failures, remaining)+ logger.warning(+ "Seedance polling hit a transient error; retrying the same task: "+ f"id={task_id}, attempt={consecutive_failures}/{MAX_POLL_RETRIES}, "+ f"retry_in={delay:.1f}s"+ )+ time.sleep(delay)+ continue++ consecutive_failures = 0+ status = str(body.get("status") or "").strip().lower()+ if status == "succeeded":+ return body+ if status in TERMINAL_FAILURE_STATUSES:+ raise VolcEngineSeedanceError(+ "Seedance task did not produce a video: "+ f"id={task_id}, status={status}, "+ f"detail={_redact_secret(body.get('error'), api_key)}",+ task_id=task_id,+ )+ if status not in ACTIVE_STATUSES:+ raise VolcEngineSeedanceUnconfirmedTaskError(+ f"Seedance returned an unknown task status: id={task_id}, status={status!r}",+ task_id=task_id,+ )+ remaining = deadline - time.monotonic()+ if remaining <= 0:+ raise VolcEngineSeedanceUnconfirmedTaskError(+ "Seedance task is still running after the configured local wait "+ f"timeout: id={task_id}",+ task_id=task_id,+ )+ time.sleep(min(poll_interval, remaining))diff --git a/cli.py b/cli.pyindex 59699fda..90053fb7 100644--- a/cli.py+++ b/cli.py@@ -253,7 +253,7 @@ Batch manifests:material_group.add_argument("--video-source",default="pexels",- choices=["pexels", "pixabay", "coverr", "local"],+ choices=["pexels", "pixabay", "coverr", "volcengine_seedance", "local"],help="video material provider; online providers require matching API keys in config.toml",)material_group.add_argument(@@ -272,6 +272,14 @@ Batch manifests:choices=_PIPELINE_STAGES,help="stop after this pipeline stage; see the stage order below",)+ material_group.add_argument(+ "--confirm-seedance-charge",+ action="store_true",+ help=(+ "confirm that Volcano Engine Seedance creates paid Ark tasks; required "+ "with --video-source volcengine_seedance for materials or video output"+ ),+ )video_group = parser.add_argument_group("video output")video_group.add_argument(@@ -550,6 +558,16 @@ Batch manifests:)if not args.batch_file and args.video_source != "local" and has_video_materials:parser.error("--video-materials can only be used with --video-source local")+ if (+ not args.batch_file+ and args.video_source == "volcengine_seedance"+ and stage_requires_materials+ and not args.confirm_seedance_charge+ ):+ parser.error(+ "--confirm-seedance-charge is required with "+ "--video-source volcengine_seedance"+ )if args.bgm_file:if args.bgm_type in (None, "custom"):@@ -923,13 +941,21 @@ def _validate_batch_task_params(*,stop_at: str,custom_position_is_explicit: bool,+ seedance_charge_confirmed: bool,) -> None:if not params.video_subject.strip() and not params.video_script.strip():raise ValueError("one of video_subject or video_script is required")- if params.video_source not in {"pexels", "pixabay", "coverr", "local"}:+ if params.video_source not in {+ "pexels",+ "pixabay",+ "coverr",+ "volcengine_seedance",+ "local",+ }:raise ValueError(- "video_source must be one of: pexels, pixabay, coverr, local"+ "video_source must be one of: pexels, pixabay, coverr, "+ "volcengine_seedance, local")for field_name, value in (("video_aspect", params.video_aspect),@@ -955,6 +981,14 @@ def _validate_batch_task_params()if params.video_source != "local" and params.video_materials:raise ValueError("video_materials can only be used with video_source=local")+ if (+ params.video_source == "volcengine_seedance"+ and stop_at in {"materials", "video"}+ and not seedance_charge_confirmed+ ):+ raise ValueError(+ "--confirm-seedance-charge is required for Volcano Engine Seedance"+ )if stop_at == "subtitle" and not params.subtitle_enabled:raise ValueError("stop_at=subtitle cannot be combined with disabled subtitles")@@ -1054,6 +1088,7 @@ def _build_batch_tasks(args: argparse.Namespace) -> list[VideoParams]:args.custom_position is not Noneor "custom_position" in override_fields),+ seedance_charge_confirmed=args.confirm_seedance_charge,)except (TypeError, ValueError) as exc:raise ValueError(f"invalid batch task {index}: {exc}") from excdiff --git a/config.example.toml b/config.example.tomlindex d37c1f85..df990bca 100644--- a/config.example.toml+++ b/config.example.toml@@ -62,8 +62,8 @@ tls_verify = true# Video Materials / 视频素材# ------------------------------------------------------------------------------# Available values: "pexels", "pixabay", "coverr", "wavespeed", "loomloom",-# "local".+# Available values: "pexels", "pixabay", "coverr", "wavespeed",+# "volcengine_seedance", "loomloom", "local".# "wavespeed" generates brand-new clips with WaveSpeed AI text-to-video models# instead of searching stock footage; generation is billed per request.# "loomloom" is a paid Shengsuan Cloud source and requires explicit@@ -96,6 +96,25 @@ wavespeed_api_keys = []# wavespeed_min_duration = 4# wavespeed_max_duration = 15+# Volcano Engine Ark Seedance uses the official asynchronous video-generation API.+# Create an Ark API key at:+# https://console.volcengine.com/ark/region:ark+cn-beijing/apikey+# When empty, VOLCENGINE_ARK_API_KEY is used, followed by the existing+# volcengine_api_key LLM setting. A single provider-specific environment variable+# avoids ambiguity with unrelated SDKs that may also use generic Ark names.+# Generation is billed per submitted clip.+volcengine_seedance_api_key = ""+volcengine_seedance_base_url = "https://ark.cn-beijing.volces.com/api/v3"+# This stable official model supports text-to-video, 2-12 second clips and 1080p.+# You may replace it with an enabled model or Endpoint ID from your Ark account.+volcengine_seedance_model = "doubao-seedance-1-0-pro-250528"+volcengine_seedance_resolution = "1080p" # "480p", "720p", or "1080p"+volcengine_seedance_min_duration = 2+volcengine_seedance_max_duration = 12+volcengine_seedance_poll_interval = 5+volcengine_seedance_run_timeout = 1800+volcengine_seedance_watermark = false+# Optional TwelveLabs integration for semantic material ranking and video QA.# Install the optional dependency with: uv sync --extra twelvelabs# Create an API key at https://playground.twelvelabs.io/diff --git a/docs/skill/SKILL.md b/docs/skill/SKILL.mdindex a94218f1..9f007716 100644--- a/docs/skill/SKILL.md+++ b/docs/skill/SKILL.md@@ -99,7 +99,7 @@ Summary: Chinese portrait video with voice-over, subtitles, and background music### Exit code 10: request credentials once-`MPT_NEEDS_INPUT` includes only the required fields, recommended LLM providers and signup links, custom OpenAI-compatible requirements, and the Pexels signup link. Ask only for the listed values and do not request credentials already found in `config.toml`.+`MPT_NEEDS_INPUT` includes only the required fields, recommended LLM providers and signup links, custom OpenAI-compatible requirements, and material-provider signup links. Ask only for the listed values and do not request credentials already found in `config.toml`.After the user responds, rerun the same foreground command with only the required environment variables:@@ -109,8 +109,13 @@ MPT_LLM_API_KEYMPT_LLM_BASE_URLMPT_LLM_MODEL_NAMEMPT_PEXELS_API_KEY+MPT_VOLCENGINE_ARK_API_KEY```+When `SEEDANCE_CHARGE_CONFIRMATION_REQUIRED` is present, explain that every+generated Seedance clip creates a paid Ark task. Only after the user explicitly+confirms, rerun with `--confirm-seedance-charge`; never add this flag silently.+### Exit code 1: repair or reportUse `MPT_ERROR` and `LOG_FILE` to repair a recoverable problem and retry once. Ask the user only if the repair requires a new API key. If the retry fails, report the failed stage, a short error, and the log path.diff --git a/docs/skill/mpt_agent.py b/docs/skill/mpt_agent.pyindex 3029e56d..928a1e5c 100644--- a/docs/skill/mpt_agent.py+++ b/docs/skill/mpt_agent.py@@ -25,7 +25,16 @@ PROJECT_ARCHIVE_URL = (DEFAULT_ROOT = Path.home() / "MoneyPrinterTurbo"DEFAULT_VOICE_NAME = "zh-CN-XiaoxiaoNeural-Female"NEEDS_INPUT_EXIT_CODE = 10-SUPPORTED_SOURCES = {"pexels", "pixabay", "coverr", "local"}+SUPPORTED_SOURCES = {+ "pexels",+ "pixabay",+ "coverr",+ "volcengine_seedance",+ "local",+}+VOLCENGINE_ARK_API_KEY_URL = (+ "https://console.volcengine.com/ark/region:ark+cn-beijing/apikey"+)PEXELS_API_KEY_URL = "https://www.pexels.com/api/"PEXELS_VALIDATION_URL = "https://api.pexels.com/v1/collections?per_page=1"PEXELS_API_KEY_HELP_URL = (@@ -206,7 +215,8 @@ def apply_environment_config(config_path: Path) -> None:base_url = os.environ.get("MPT_LLM_BASE_URL", "").strip()model_name = os.environ.get("MPT_LLM_MODEL_NAME", "").strip()pexels_key = os.environ.get("MPT_PEXELS_API_KEY", "").strip()- if not any((provider, llm_key, base_url, model_name, pexels_key)):+ seedance_key = os.environ.get("MPT_VOLCENGINE_ARK_API_KEY", "").strip()+ if not any((provider, llm_key, base_url, model_name, pexels_key, seedance_key)):returntext = config_path.read_text(encoding="utf-8")@@ -228,6 +238,11 @@ def apply_environment_config(config_path: Path) -> None:if pexels_key:text = _replace_config_value(text, "pexels_api_keys", [pexels_key])changes.append("pexels_api_keys")+ if seedance_key:+ text = _replace_config_value(+ text, "volcengine_seedance_api_key", seedance_key+ )+ changes.append("volcengine_seedance_api_key")config_path.write_text(text, encoding="utf-8")log("updated configuration fields: " + ", ".join(changes))@@ -307,7 +322,19 @@ def missing_config(config_path: Path, cli_args: list[str]) -> tuple[str, list[stsource = selected_video_source(cli_args)if source not in SUPPORTED_SOURCES:raise SkillError(f"unsupported video source: {source}")- if source != "local":+ if source == "volcengine_seedance":+ # 与运行时 Provider 保持完全一致的凭据优先级,避免 Skill 预检通过后+ # 主程序却读取了另一把 Key。ARK_API_KEY 语义过于宽泛,明确不再兼容。+ value = (+ _plain_config_value(text, "volcengine_seedance_api_key")+ or os.environ.get("VOLCENGINE_ARK_API_KEY", "").strip()+ or _plain_config_value(text, "volcengine_api_key")+ )+ if not _has_configured_value(value):+ missing.append("volcengine_seedance_api_key")+ if not has_cli_option(cli_args, "--confirm-seedance-charge"):+ missing.append("confirm_seedance_charge")+ elif source != "local":value = _plain_config_value(text, f"{source}_api_keys")if not _has_configured_value(value):missing.append(f"{source}_api_keys")@@ -320,7 +347,11 @@ def report_missing_config(provider: str, missing: list[str]) -> int:print(f"LLM_PROVIDER={provider}")for field in missing:print(f"MISSING={field}")- if any(field.endswith("_api_key") for field in missing):+ if any(+ field.endswith("_api_key")+ and field != "volcengine_seedance_api_key"+ for field in missing+ ):print("LLM_PROVIDER_OPTIONS_BEGIN")for provider_id, (label, url) in RECOMMENDED_LLM_PROVIDERS.items():print(f"LLM_PROVIDER_OPTION={provider_id}|{label}|{url}")@@ -337,6 +368,11 @@ def report_missing_config(provider: str, missing: list[str]) -> int:if "pexels_api_keys" in missing:print(f"PEXELS_API_KEY_URL={PEXELS_API_KEY_URL}")print(f"PEXELS_API_KEY_HELP_URL={PEXELS_API_KEY_HELP_URL}")+ if "volcengine_seedance_api_key" in missing:+ print(f"VOLCENGINE_ARK_API_KEY_URL={VOLCENGINE_ARK_API_KEY_URL}")+ print("VOLCENGINE_ARK_API_KEY_ENV=MPT_VOLCENGINE_ARK_API_KEY")+ if "confirm_seedance_charge" in missing:+ print("SEEDANCE_CHARGE_CONFIRMATION_REQUIRED=--confirm-seedance-charge")print("Request only the listed values, set the environment variables, and rerun the same command.")return NEEDS_INPUT_EXIT_CODEdiff --git a/test/services/test_cli.py b/test/services/test_cli.pyindex ec7d4f03..3d9f1331 100644--- a/test/services/test_cli.py+++ b/test/services/test_cli.py@@ -129,6 +129,86 @@ class TestCli(unittest.TestCase):params = cli.build_video_params(args)self.assertEqual(params.video_source, "coverr")+ def test_seedance_video_source_requires_explicit_charge_confirmation(self):+ with self.assertRaises(SystemExit) as raised:+ cli.parse_args(+ [+ "--video-subject",+ "test",+ "--video-source",+ "volcengine_seedance",+ ]+ )+ self.assertEqual(raised.exception.code, 2)++ args = cli.parse_args(+ [+ "--video-subject",+ "test",+ "--video-source",+ "volcengine_seedance",+ "--confirm-seedance-charge",+ ]+ )+ self.assertEqual(+ cli.build_video_params(args).video_source, "volcengine_seedance"+ )++ def test_seedance_confirmation_is_not_required_before_material_stage(self):+ args = cli.parse_args(+ [+ "--video-subject",+ "test",+ "--video-source",+ "volcengine_seedance",+ "--stop-at",+ "script",+ ]+ )+ self.assertEqual(args.video_source, "volcengine_seedance")++ def test_batch_seedance_source_uses_global_charge_confirmation(self):+ with tempfile.TemporaryDirectory() as temp_dir:+ manifest = Path(temp_dir) / "tasks.json"+ manifest.write_text(+ json.dumps(+ [+ {+ "video_subject": "Seedance batch task",+ "video_source": "volcengine_seedance",+ }+ ]+ ),+ encoding="utf-8",+ )+ with patch("app.services.task.start") as start:+ rejected = cli.run_cli(+ ["--batch-file", str(manifest), "--stop-at", "materials"]+ )+ self.assertEqual(rejected, 2)+ start.assert_not_called()++ with (+ patch(+ "app.services.task.start",+ return_value={"state": 1, "materials": ["ok"]},+ ) as start,+ patch("app.utils.utils.get_uuid", return_value="task-seedance"),+ redirect_stdout(io.StringIO()),+ ):+ accepted = cli.run_cli(+ [+ "--batch-file",+ str(manifest),+ "--stop-at",+ "materials",+ "--confirm-seedance-charge",+ ]+ )++ self.assertEqual(accepted, 0)+ start.assert_called_once()+def test_build_video_params_with_script_video_and_audio_options(self):args = cli.parse_args([diff --git a/test/services/test_config.py b/test/services/test_config.pyindex 1dc235db..5729bc54 100644--- a/test/services/test_config.py+++ b/test/services/test_config.py@@ -41,6 +41,7 @@ class TestConfigPersistence:"pexels","pixabay","coverr",+ "volcengine_seedance","loomloom","local",}@@ -48,6 +49,9 @@ class TestConfigPersistence:assert app_config["script_generation_backend"] == "local"assert app_config["loomloom_api_token"] == ""assert app_config["loomloom_video_run_timeout_seconds"] == 1800+ assert app_config["volcengine_seedance_api_key"] == ""+ assert app_config["volcengine_seedance_base_url"].startswith("https://")+ assert app_config["volcengine_seedance_model"]assert "loomloom_market_listing_id" not in app_configassert "loomloom_video_market_listing_id" not in app_configassert app_config["shengsuanyun_api_key"] == ""diff --git a/test/services/test_mpt_agent_skill.py b/test/services/test_mpt_agent_skill.pyindex c9ce0141..58183bc9 100644--- a/test/services/test_mpt_agent_skill.py+++ b/test/services/test_mpt_agent_skill.py@@ -28,6 +28,7 @@ deepseek_api_key = ""pexels_api_keys = []pixabay_api_keys = []coverr_api_keys = []+volcengine_seedance_api_key = ""oneapi_api_key = ""oneapi_base_url = ""oneapi_model_name = ""@@ -98,6 +99,7 @@ class TestMptAgentSkill(unittest.TestCase):output = io.StringIO()llm_key = "secret-llm-key"pexels_key = "secret-pexels-key"+ seedance_key = "secret-ark-key"with patch.dict(os.environ,@@ -105,6 +107,7 @@ class TestMptAgentSkill(unittest.TestCase):"MPT_LLM_PROVIDER": "deepseek","MPT_LLM_API_KEY": llm_key,"MPT_PEXELS_API_KEY": pexels_key,+ "MPT_VOLCENGINE_ARK_API_KEY": seedance_key,},clear=True,), redirect_stdout(output):@@ -114,8 +117,12 @@ class TestMptAgentSkill(unittest.TestCase):self.assertIn('llm_provider = "deepseek"', config)self.assertIn(f'deepseek_api_key = "{llm_key}"', config)self.assertIn(f'pexels_api_keys = ["{pexels_key}"]', config)+ self.assertIn(+ f'volcengine_seedance_api_key = "{seedance_key}"', config+ )self.assertNotIn(llm_key, output.getvalue())self.assertNotIn(pexels_key, output.getvalue())+ self.assertNotIn(seedance_key, output.getvalue())def test_material_key_check_matches_selected_source(self):with tempfile.TemporaryDirectory() as temp_dir:@@ -135,6 +142,67 @@ class TestMptAgentSkill(unittest.TestCase):self.assertEqual(default_missing, ["pexels_api_keys"])self.assertEqual(pixabay_missing, [])+ def test_seedance_source_requires_key_and_explicit_charge_confirmation(self):+ with tempfile.TemporaryDirectory() as temp_dir:+ config_path = Path(temp_dir) / "config.toml"+ config_path.write_text(+ MINIMAL_CONFIG.replace(+ 'moonshot_api_key = ""', 'moonshot_api_key = "configured"'+ ),+ encoding="utf-8",+ )++ _, missing = mpt_agent.missing_config(+ config_path, ["--video-source", "volcengine_seedance"]+ )+ self.assertEqual(+ missing,+ ["volcengine_seedance_api_key", "confirm_seedance_charge"],+ )++ config_path.write_text(+ config_path.read_text(encoding="utf-8").replace(+ 'volcengine_seedance_api_key = ""',+ 'volcengine_seedance_api_key = "configured"',+ ),+ encoding="utf-8",+ )+ _, confirmed_missing = mpt_agent.missing_config(+ config_path,+ [+ "--video-source",+ "volcengine_seedance",+ "--confirm-seedance-charge",+ ],+ )+ self.assertEqual(confirmed_missing, [])++ def test_seedance_source_accepts_the_official_specific_environment_key(self):+ with tempfile.TemporaryDirectory() as temp_dir:+ config_path = Path(temp_dir) / "config.toml"+ config_path.write_text(+ MINIMAL_CONFIG.replace(+ 'moonshot_api_key = ""', 'moonshot_api_key = "configured"'+ ),+ encoding="utf-8",+ )++ with patch.dict(+ os.environ,+ {"VOLCENGINE_ARK_API_KEY": "environment-ark-key"},+ clear=True,+ ):+ _, missing = mpt_agent.missing_config(+ config_path,+ [+ "--video-source",+ "volcengine_seedance",+ "--confirm-seedance-charge",+ ],+ )++ self.assertEqual(missing, [])+def test_existing_provider_key_is_reused_without_asking_user(self):with tempfile.TemporaryDirectory() as temp_dir:config_path = Path(temp_dir) / "config.toml"@@ -172,6 +240,26 @@ class TestMptAgentSkill(unittest.TestCase):self.assertIn(f"PEXELS_API_KEY_URL={mpt_agent.PEXELS_API_KEY_URL}", text)self.assertNotIn("LLM_PROVIDER_OPTIONS_BEGIN", text)+ def test_missing_seedance_inputs_report_ark_signup_and_charge_flag(self):+ output = io.StringIO()+ with redirect_stdout(output):+ code = mpt_agent.report_missing_config(+ "deepseek",+ ["volcengine_seedance_api_key", "confirm_seedance_charge"],+ )++ text = output.getvalue()+ self.assertEqual(code, mpt_agent.NEEDS_INPUT_EXIT_CODE)+ self.assertIn(+ f"VOLCENGINE_ARK_API_KEY_URL={mpt_agent.VOLCENGINE_ARK_API_KEY_URL}",+ text,+ )+ self.assertIn(+ "SEEDANCE_CHARGE_CONFIRMATION_REQUIRED=--confirm-seedance-charge",+ text,+ )+ self.assertNotIn("LLM_PROVIDER_OPTIONS_BEGIN", text)+def test_custom_openai_compatible_provider_requires_connection_details(self):with tempfile.TemporaryDirectory() as temp_dir:config_path = Path(temp_dir) / "config.toml"diff --git a/test/services/test_volcengine_seedance.py b/test/services/test_volcengine_seedance.pynew file mode 100644index 00000000..5f416598--- /dev/null+++ b/test/services/test_volcengine_seedance.py@@ -0,0 +1,827 @@+import os+import unittest+from types import SimpleNamespace+from unittest.mock import patch++import requests++from app.config import config+from app.models.schema import MaterialInfo, VideoAspect, VideoParams+from app.services import material, state as sm, task as task_service+from app.services import volcengine_seedance as seedance+++class TestVolcEngineSeedanceService(unittest.TestCase):+ def setUp(self):+ self.original_app = dict(config.app)+ self.original_proxy = dict(config.proxy)+ config.app.update(+ {+ "volcengine_seedance_api_key": "ark-test-key",+ "volcengine_seedance_model": seedance.DEFAULT_MODEL_ID,+ "volcengine_seedance_base_url": seedance.DEFAULT_BASE_URL,+ }+ )+ config.proxy.clear()++ def tearDown(self):+ config.app.clear()+ config.app.update(self.original_app)+ config.proxy.clear()+ config.proxy.update(self.original_proxy)++ @staticmethod+ def _response(payload, status_code=200):+ return SimpleNamespace(status_code=status_code, json=lambda: payload)++ def test_api_key_uses_one_provider_specific_environment_name(self):+ with patch.dict(+ os.environ,+ {+ "VOLCENGINE_ARK_API_KEY": "env-key",+ "ARK_API_KEY": "generic-key-must-be-ignored",+ },+ clear=False,+ ):+ self.assertEqual(seedance.get_api_key(), "ark-test-key")+ config.app["volcengine_seedance_api_key"] = ""+ config.app["volcengine_api_key"] = "shared-ark-key"+ self.assertEqual(seedance.get_api_key(), "env-key")+ os.environ["VOLCENGINE_ARK_API_KEY"] = ""+ self.assertEqual(seedance.get_api_key(), "shared-ark-key")+ config.app["volcengine_api_key"] = ""+ self.assertEqual(seedance.get_api_key(), "")++ def test_missing_api_key_fails_before_submission(self):+ config.app["volcengine_seedance_api_key"] = ""+ config.app["volcengine_api_key"] = ""+ with (+ patch.dict(+ os.environ,+ {"VOLCENGINE_ARK_API_KEY": ""},+ clear=False,+ ),+ patch.object(seedance.requests, "post") as post,+ ):+ with self.assertRaises(seedance.VolcEngineSeedanceError):+ seedance.generate_videos("sunrise", 5)+ post.assert_not_called()++ def test_empty_search_term_fails_before_paid_submission(self):+ for invalid in ("", " ", None, 0, False):+ with self.subTest(invalid=invalid):+ with patch.object(seedance.requests, "post") as post:+ with self.assertRaises(seedance.VolcEngineSeedanceError) as raised:+ seedance.generate_videos(invalid, 5)++ self.assertIn("search term must not be empty", str(raised.exception))+ post.assert_not_called()++ def test_search_term_is_trimmed_consistently_in_request_and_source_record(self):+ submit = self._response({"id": "cgt-trimmed"})+ completed = self._response(+ {+ "id": "cgt-trimmed",+ "status": "succeeded",+ "content": {"video_url": "https://cdn.example.com/trimmed.mp4"},+ }+ )+ with (+ patch.object(seedance.requests, "post", return_value=submit) as post,+ patch.object(seedance.requests, "get", return_value=completed),+ ):+ result = seedance.generate_videos(" smart home ", 5)++ self.assertEqual(+ post.call_args.kwargs["json"]["content"],+ [{"type": "text", "text": "smart home"}],+ )+ self.assertEqual(result[0].source_info["search_term"], "smart home")++ def test_submit_poll_and_parse_successful_video(self):+ submit = self._response({"id": "cgt-123"})+ polls = [+ self._response({"id": "cgt-123", "status": "running"}),+ self._response(+ {+ "id": "cgt-123",+ "status": "succeeded",+ "content": {+ "video_url": "https://cdn.example.com/video.mp4?sig=abc"+ },+ }+ ),+ ]++ with (+ patch.object(seedance.requests, "post", return_value=submit) as post,+ patch.object(seedance.requests, "get", side_effect=polls) as get,+ patch.object(seedance.time, "sleep") as sleep,+ ):+ result = seedance.generate_videos(+ "sunrise over mountains",+ minimum_duration=5,+ video_aspect=VideoAspect.portrait,+ )++ self.assertEqual(len(result), 1)+ item = result[0]+ self.assertEqual(item.provider, "volcengine_seedance")+ self.assertEqual(item.url, "https://cdn.example.com/video.mp4?sig=abc")+ self.assertEqual(item.duration, 5)+ self.assertEqual(item.source_info["asset_id"], "cgt-123")+ self.assertEqual(item.source_info["rendition"]["width"], 1080)+ self.assertEqual(item.source_info["rendition"]["height"], 1920)++ self.assertEqual(+ post.call_args.args[0],+ f"{seedance.DEFAULT_BASE_URL}/contents/generations/tasks",+ )+ self.assertEqual(+ post.call_args.kwargs["headers"]["Authorization"],+ "Bearer ark-test-key",+ )+ self.assertEqual(+ post.call_args.kwargs["json"],+ {+ "model": seedance.DEFAULT_MODEL_ID,+ "content": [+ {"type": "text", "text": "sunrise over mountains"}+ ],+ "ratio": "9:16",+ "duration": 5,+ "resolution": "1080p",+ "watermark": False,+ },+ )+ self.assertEqual(get.call_count, 2)+ self.assertTrue(+ all("/contents/generations/tasks/cgt-123" in call.args[0] for call in get.call_args_list)+ )+ sleep.assert_called_once_with(seedance.DEFAULT_POLL_INTERVAL_SECONDS)++ def test_rendition_size_matches_real_ark_outputs(self):+ self.assertEqual(+ seedance._rendition_size(VideoAspect.portrait, "480p"),+ (480, 864),+ )+ self.assertEqual(+ seedance._rendition_size(VideoAspect.landscape, "720p"),+ (1280, 720),+ )+ self.assertEqual(+ seedance._rendition_size(VideoAspect.square, "1080p"),+ (1080, 1080),+ )++ def test_invalid_resolution_fails_before_paid_submission(self):+ for invalid in ("480", "", " ", None, 0, False, "4k"):+ with self.subTest(invalid=invalid):+ config.app["volcengine_seedance_resolution"] = invalid+ with patch.object(seedance.requests, "post") as post:+ with self.assertRaises(seedance.VolcEngineSeedanceError) as raised:+ seedance.generate_videos("city", 5)++ self.assertIn(+ "Unsupported Seedance resolution", str(raised.exception)+ )+ post.assert_not_called()++ def test_resolution_defaults_only_when_missing_and_normalizes_supported_value(self):+ config.app.pop("volcengine_seedance_resolution", None)+ self.assertEqual(seedance._resolution(), seedance.DEFAULT_RESOLUTION)++ config.app["volcengine_seedance_resolution"] = " 720P "+ self.assertEqual(seedance._resolution(), "720p")++ def test_configured_model_base_url_and_duration_bounds_are_applied(self):+ config.app.update(+ {+ "volcengine_seedance_model": "ep-custom",+ "volcengine_seedance_base_url": "https://ark.example.test/api/v3/",+ "volcengine_seedance_min_duration": 4,+ "volcengine_seedance_max_duration": 8,+ "volcengine_seedance_resolution": "720p",+ "volcengine_seedance_watermark": True,+ }+ )+ submit = self._response({"id": "cgt-bounds"})+ completed = self._response(+ {+ "id": "cgt-bounds",+ "status": "succeeded",+ "content": {"video_url": "https://cdn.example.com/bounds.mp4"},+ }+ )+ with (+ patch.object(seedance.requests, "post", return_value=submit) as post,+ patch.object(seedance.requests, "get", return_value=completed),+ ):+ result = seedance.generate_videos("city", 99, VideoAspect.landscape)++ self.assertEqual(result[0].duration, 8)+ self.assertEqual(+ post.call_args.args[0],+ "https://ark.example.test/api/v3/contents/generations/tasks",+ )+ payload = post.call_args.kwargs["json"]+ self.assertEqual(payload["model"], "ep-custom")+ self.assertEqual(payload["duration"], 8)+ self.assertEqual(payload["resolution"], "720p")+ self.assertTrue(payload["watermark"])++ def test_rejected_submission_raises_clear_error_without_polling(self):+ rejected = self._response(+ {+ "error": {+ "code": "InputTextSensitiveContentDetected",+ "message": "rejected ark-test-key",+ }+ },+ status_code=400,+ )+ with (+ patch.object(seedance.requests, "post", return_value=rejected),+ patch.object(seedance.requests, "get") as get,+ ):+ with self.assertRaises(seedance.VolcEngineSeedanceError) as raised:+ seedance.generate_videos("unsafe", 5)++ get.assert_not_called()+ self.assertNotIn("ark-test-key", str(raised.exception))++ def test_submission_network_or_server_error_is_unconfirmed_and_not_retried(self):+ for side_effect, response in (+ (requests.exceptions.ConnectionError("offline"), None),+ (None, self._response({"message": "bad gateway"}, status_code=502)),+ ):+ with self.subTest(response=response):+ with patch.object(+ seedance.requests,+ "post",+ side_effect=side_effect,+ return_value=response,+ ) as post:+ with self.assertRaises(+ seedance.VolcEngineSeedanceUnconfirmedTaskError+ ):+ seedance.generate_videos("sunrise", 5)+ self.assertEqual(post.call_count, 1)++ def test_poll_retries_transient_errors_on_same_task(self):+ submit = self._response({"id": "cgt-retry"})+ rate_limited = self._response({}, status_code=429)+ completed = self._response(+ {+ "id": "cgt-retry",+ "status": "succeeded",+ "content": {"video_url": "https://cdn.example.com/retry.mp4"},+ }+ )+ with (+ patch.object(seedance.requests, "post", return_value=submit) as post,+ patch.object(+ seedance.requests,+ "get",+ side_effect=[+ rate_limited,+ requests.exceptions.ConnectionError("offline"),+ completed,+ ],+ ) as get,+ patch.object(seedance.time, "sleep") as sleep,+ ):+ result = seedance.generate_videos("sunrise", 5)++ self.assertEqual(len(result), 1)+ self.assertEqual(post.call_count, 1)+ self.assertEqual(get.call_count, 3)+ self.assertEqual([call.args[0] for call in sleep.call_args_list], [1.0, 2.0])++ def test_poll_retry_exhaustion_preserves_remote_task_id(self):+ submit = self._response({"id": "cgt-stuck"})+ with (+ patch.object(seedance.requests, "post", return_value=submit),+ patch.object(+ seedance.requests,+ "get",+ side_effect=requests.exceptions.ConnectionError("offline"),+ ) as get,+ patch.object(seedance.time, "sleep"),+ ):+ with self.assertRaises(+ seedance.VolcEngineSeedanceUnconfirmedTaskError+ ) as raised:+ seedance.generate_videos("sunrise", 5)++ self.assertEqual(raised.exception.task_id, "cgt-stuck")+ self.assertEqual(get.call_count, seedance.MAX_POLL_RETRIES + 1)++ def test_running_task_timeout_preserves_remote_task_id(self):+ submit = self._response({"id": "cgt-running"})+ running = self._response({"id": "cgt-running", "status": "running"})+ clock = iter([0.0, 1.0, seedance.DEFAULT_RUN_TIMEOUT_SECONDS + 1])+ with (+ patch.object(seedance.requests, "post", return_value=submit),+ patch.object(seedance.requests, "get", return_value=running),+ patch.object(seedance.time, "monotonic", side_effect=lambda: next(clock)),+ ):+ with self.assertRaises(+ seedance.VolcEngineSeedanceUnconfirmedTaskError+ ) as raised:+ seedance.generate_videos("sunrise", 5)++ self.assertEqual(raised.exception.task_id, "cgt-running")++ def test_network_retry_stops_when_total_run_deadline_is_reached(self):+ # 第一次请求前仍有 59 秒;请求异常返回时总截止时间已经过去,不能继续+ # 执行其余五次网络重试,也不能再进入退避 sleep。+ config.app["volcengine_seedance_run_timeout"] = 60+ clock = iter([0.0, 1.0, 61.0])+ with (+ patch.object(+ seedance.requests,+ "get",+ side_effect=requests.exceptions.Timeout("slow"),+ ) as get,+ patch.object(seedance.time, "monotonic", side_effect=lambda: next(clock)),+ patch.object(seedance.time, "sleep") as sleep,+ ):+ with self.assertRaises(+ seedance.VolcEngineSeedanceUnconfirmedTaskError+ ) as raised:+ seedance._wait_for_task(+ task_id="cgt-network-timeout",+ tasks_url="https://ark.example.test/tasks",+ headers={},+ api_key="ark-test-key",+ )++ self.assertEqual(raised.exception.task_id, "cgt-network-timeout")+ self.assertEqual(get.call_count, 1)+ self.assertEqual(get.call_args.kwargs["timeout"], (29.5, 29.5))+ sleep.assert_not_called()++ def test_expired_run_deadline_stops_before_remote_poll(self):+ config.app["volcengine_seedance_run_timeout"] = 60+ clock = iter([0.0, 61.0])+ with (+ patch.object(seedance.requests, "get") as get,+ patch.object(seedance.time, "monotonic", side_effect=lambda: next(clock)),+ ):+ with self.assertRaises(+ seedance.VolcEngineSeedanceUnconfirmedTaskError+ ) as raised:+ seedance._wait_for_task(+ task_id="cgt-expired",+ tasks_url="https://ark.example.test/tasks",+ headers={},+ api_key="ark-test-key",+ )++ self.assertEqual(raised.exception.task_id, "cgt-expired")+ get.assert_not_called()++ def test_active_poll_sleep_is_capped_by_remaining_deadline(self):+ config.app.update(+ {+ "volcengine_seedance_run_timeout": 60,+ "volcengine_seedance_poll_interval": 5,+ }+ )+ running = self._response({"id": "cgt-running", "status": "running"})+ # 第一次响应完成时只剩 0.25 秒,应只休眠剩余时间;下一轮在发起+ # 网络请求前发现截止时间已过,避免额外一次远端请求。+ clock = iter([0.0, 59.0, 59.75, 60.1])+ with (+ patch.object(seedance.requests, "get", return_value=running) as get,+ patch.object(seedance.time, "monotonic", side_effect=lambda: next(clock)),+ patch.object(seedance.time, "sleep") as sleep,+ ):+ with self.assertRaises(seedance.VolcEngineSeedanceUnconfirmedTaskError):+ seedance._wait_for_task(+ task_id="cgt-running",+ tasks_url="https://ark.example.test/tasks",+ headers={},+ api_key="ark-test-key",+ )++ self.assertEqual(get.call_count, 1)+ sleep.assert_called_once_with(0.25)++ def test_retry_backoff_is_capped_by_remaining_deadline(self):+ config.app["volcengine_seedance_run_timeout"] = 60+ clock = iter([0.0, 59.0, 59.75, 60.1])+ with (+ patch.object(+ seedance.requests,+ "get",+ side_effect=requests.exceptions.Timeout("slow"),+ ) as get,+ patch.object(seedance.time, "monotonic", side_effect=lambda: next(clock)),+ patch.object(seedance.time, "sleep") as sleep,+ ):+ with self.assertRaises(seedance.VolcEngineSeedanceUnconfirmedTaskError):+ seedance._wait_for_task(+ task_id="cgt-retry-deadline",+ tasks_url="https://ark.example.test/tasks",+ headers={},+ api_key="ark-test-key",+ )++ self.assertEqual(get.call_count, 1)+ self.assertEqual(get.call_args.kwargs["timeout"], (0.5, 0.5))+ sleep.assert_called_once_with(0.25)++ def test_non_retryable_poll_response_stops_and_redacts_secret(self):+ unauthorized = self._response(+ {"error": {"code": "Unauthorized", "message": "ark-test-key"}},+ status_code=401,+ )+ with (+ patch.object(seedance.requests, "get", return_value=unauthorized) as get,+ patch.object(seedance.time, "sleep") as sleep,+ ):+ with self.assertRaises(+ seedance.VolcEngineSeedanceUnconfirmedTaskError+ ) as raised:+ seedance._wait_for_task(+ task_id="cgt-unauthorized",+ tasks_url="https://ark.example.test/tasks",+ headers={},+ api_key="ark-test-key",+ )++ self.assertEqual(raised.exception.task_id, "cgt-unauthorized")+ self.assertNotIn("ark-test-key", str(raised.exception))+ self.assertEqual(get.call_count, 1)+ sleep.assert_not_called()++ def test_malformed_poll_payload_preserves_remote_task_id(self):+ for payload in ([], None, "running"):+ with self.subTest(payload=payload):+ with patch.object(+ seedance.requests, "get", return_value=self._response(payload)+ ):+ with self.assertRaises(+ seedance.VolcEngineSeedanceUnconfirmedTaskError+ ) as raised:+ seedance._wait_for_task(+ task_id="cgt-malformed",+ tasks_url="https://ark.example.test/tasks",+ headers={},+ api_key="ark-test-key",+ )++ self.assertEqual(raised.exception.task_id, "cgt-malformed")++ def test_all_terminal_status_aliases_preserve_remote_task_id(self):+ for status in seedance.TERMINAL_FAILURE_STATUSES:+ with self.subTest(status=status):+ terminal = self._response(+ {"id": "cgt-terminal", "status": status, "error": {}}+ )+ with patch.object(seedance.requests, "get", return_value=terminal):+ with self.assertRaises(seedance.VolcEngineSeedanceError) as raised:+ seedance._wait_for_task(+ task_id="cgt-terminal",+ tasks_url="https://ark.example.test/tasks",+ headers={},+ api_key="ark-test-key",+ )++ self.assertEqual(raised.exception.task_id, "cgt-terminal")++ def test_unknown_remote_status_is_unconfirmed_and_preserves_task_id(self):+ unknown = self._response({"id": "cgt-unknown", "status": "pausing"})+ with patch.object(seedance.requests, "get", return_value=unknown):+ with self.assertRaises(+ seedance.VolcEngineSeedanceUnconfirmedTaskError+ ) as raised:+ seedance._wait_for_task(+ task_id="cgt-unknown",+ tasks_url="https://ark.example.test/tasks",+ headers={},+ api_key="ark-test-key",+ )++ self.assertEqual(raised.exception.task_id, "cgt-unknown")++ def test_terminal_failure_preserves_remote_task_id(self):+ submit = self._response({"id": "cgt-failed"})+ failed = self._response(+ {+ "id": "cgt-failed",+ "status": "failed",+ "error": {"code": "OutputVideoSensitiveContentDetected"},+ }+ )+ with (+ patch.object(seedance.requests, "post", return_value=submit),+ patch.object(seedance.requests, "get", return_value=failed),+ ):+ with self.assertRaises(seedance.VolcEngineSeedanceError) as raised:+ seedance.generate_videos("sunrise", 5)++ self.assertEqual(raised.exception.task_id, "cgt-failed")++ def test_missing_task_id_is_treated_as_unconfirmed(self):+ for payload in ({}, {"id": " "}, [], None):+ with self.subTest(payload=payload):+ with (+ patch.object(+ seedance.requests, "post", return_value=self._response(payload)+ ),+ patch.object(seedance.requests, "get") as get,+ ):+ with self.assertRaises(+ seedance.VolcEngineSeedanceUnconfirmedTaskError+ ):+ seedance.generate_videos("sunrise", 5)+ get.assert_not_called()++ def test_succeeded_task_without_video_url_stops_as_protocol_error(self):+ submit = self._response({"id": "cgt-no-url"})+ completed = self._response(+ {"id": "cgt-no-url", "status": "succeeded", "content": {}}+ )+ with (+ patch.object(seedance.requests, "post", return_value=submit),+ patch.object(seedance.requests, "get", return_value=completed),+ ):+ with self.assertRaises(seedance.VolcEngineSeedanceError) as raised:+ seedance.generate_videos("sunrise", 5)++ self.assertEqual(raised.exception.task_id, "cgt-no-url")+++class TestVolcEngineSeedanceMaterialIntegration(unittest.TestCase):+ @staticmethod+ def _item(term: str, url: str) -> MaterialInfo:+ return MaterialInfo(+ provider="volcengine_seedance",+ url=url,+ duration=5,+ source_info={+ "provider": "volcengine_seedance",+ "search_term": term,+ "asset_id": f"task-{term}",+ },+ )++ def test_on_demand_generation_stops_when_duration_is_covered(self):+ with (+ patch.object(+ seedance,+ "generate_videos",+ side_effect=[+ [self._item("one", "https://cdn.example.com/one.mp4")],+ [self._item("two", "https://cdn.example.com/two.mp4")],+ ],+ ) as generate,+ patch.object(+ material,+ "save_video",+ side_effect=["/tmp/one.mp4", "/tmp/two.mp4"],+ ),+ patch.object(material, "_persist_material_sources") as persist,+ ):+ result = material.download_videos(+ task_id="seedance-materials",+ search_terms=["one", "two", "three"],+ source="volcengine_seedance",+ audio_duration=10,+ max_clip_duration=5,+ )++ self.assertEqual(result, ["/tmp/one.mp4", "/tmp/two.mp4"])+ self.assertEqual(generate.call_count, 2)+ self.assertEqual(persist.call_args.args[0], "seedance-materials")+ self.assertEqual(len(persist.call_args.args[1]), 2)++ def test_non_positive_audio_duration_avoids_paid_submission(self):+ for audio_duration in (0, -1, -0.1):+ with self.subTest(audio_duration=audio_duration):+ with (+ patch.object(seedance, "generate_videos") as generate,+ patch.object(material, "_persist_material_sources") as persist,+ ):+ result = material.download_videos(+ task_id="seedance-no-audio",+ search_terms=["one", "two"],+ source="volcengine_seedance",+ audio_duration=audio_duration,+ max_clip_duration=5,+ )++ self.assertEqual(result, [])+ generate.assert_not_called()+ persist.assert_called_once_with("seedance-no-audio", [])++ def test_non_finite_or_invalid_audio_duration_fails_before_paid_submission(self):+ for audio_duration in (float("nan"), float("inf"), float("-inf"), None, "bad"):+ with self.subTest(audio_duration=audio_duration):+ with patch.object(seedance, "generate_videos") as generate:+ with self.assertRaises(seedance.VolcEngineSeedanceError) as raised:+ material.download_videos(+ task_id="seedance-invalid-audio",+ search_terms=["one", "two"],+ source="volcengine_seedance",+ audio_duration=audio_duration,+ max_clip_duration=5,+ )++ self.assertIn("audio duration", str(raised.exception))+ generate.assert_not_called()++ def test_invalid_clip_duration_fails_before_paid_submission(self):+ for clip_duration in (0, -1, None, "bad", float("nan"), float("inf")):+ with self.subTest(clip_duration=clip_duration):+ with patch.object(seedance, "generate_videos") as generate:+ with self.assertRaises(seedance.VolcEngineSeedanceError) as raised:+ material.download_videos(+ task_id="seedance-invalid-clip",+ search_terms=["one", "two"],+ source="volcengine_seedance",+ audio_duration=10,+ max_clip_duration=clip_duration,+ )++ self.assertIn("clip duration", str(raised.exception))+ generate.assert_not_called()++ def test_unconfirmed_task_stops_later_paid_submissions(self):+ with (+ patch.object(+ seedance,+ "generate_videos",+ side_effect=seedance.VolcEngineSeedanceUnconfirmedTaskError(+ "unknown", task_id="cgt-stuck"+ ),+ ) as generate,+ patch.object(material, "save_video") as save,+ ):+ with self.assertRaises(+ seedance.VolcEngineSeedanceUnconfirmedTaskError+ ):+ material.download_videos(+ task_id="seedance-unconfirmed",+ search_terms=["one", "two"],+ source="volcengine_seedance",+ audio_duration=10,+ max_clip_duration=5,+ )++ self.assertEqual(generate.call_count, 1)+ save.assert_not_called()++ def test_download_failure_stops_later_paid_submissions(self):+ first_item = self._item("one", "https://cdn.example.com/one.mp4")+ with (+ patch.object(seedance, "generate_videos", return_value=[first_item]) as generate,+ patch.object(material, "_save_generated_video_with_retry", return_value=""),+ ):+ with self.assertRaises(seedance.VolcEngineSeedanceDownloadError) as raised:+ material.download_videos(+ task_id="seedance-download-failed",+ search_terms=["one", "two"],+ source="volcengine_seedance",+ audio_duration=10,+ max_clip_duration=5,+ )++ self.assertEqual(raised.exception.task_id, "task-one")+ self.assertEqual(generate.call_count, 1)++ def test_later_download_failure_preserves_prior_material_sources(self):+ first_item = self._item("one", "https://cdn.example.com/one.mp4")+ second_item = self._item("two", "https://cdn.example.com/two.mp4")+ with (+ patch.object(+ seedance,+ "generate_videos",+ side_effect=[[first_item], [second_item]],+ ) as generate,+ patch.object(+ material,+ "_save_generated_video_with_retry",+ side_effect=["/tmp/one.mp4", ""],+ ),+ patch.object(material, "_persist_material_sources") as persist,+ ):+ with self.assertRaises(seedance.VolcEngineSeedanceDownloadError) as raised:+ material.download_videos(+ task_id="seedance-partial-download",+ search_terms=["one", "two", "three"],+ source="volcengine_seedance",+ audio_duration=15,+ max_clip_duration=5,+ )++ self.assertEqual(raised.exception.task_id, "task-two")+ self.assertEqual(generate.call_count, 2)+ persisted_task_id, persisted_sources = persist.call_args.args+ self.assertEqual(persisted_task_id, "seedance-partial-download")+ self.assertEqual(len(persisted_sources), 1)+ self.assertEqual(persisted_sources[0]["asset_id"], "task-one")++ def test_task_preflight_rejects_missing_ark_key_before_script_generation(self):+ params = VideoParams(+ video_subject="Seedance preflight",+ video_source="volcengine_seedance",+ )+ memory_state = sm.MemoryState()+ with (+ patch.object(seedance, "is_enabled", return_value=False),+ patch.object(task_service.sm, "state", memory_state),+ patch.object(task_service, "generate_script") as generate_script,+ ):+ result = task_service.start(+ "seedance-preflight", params, stop_at="materials"+ )++ self.assertEqual(result["failed_stage"], "preflight")+ self.assertIn("Ark API key", result["error"])+ generate_script.assert_not_called()++ def test_task_records_seedance_material_error_and_remote_task_id(self):+ params = VideoParams(+ video_subject="Seedance material failure",+ video_source="volcengine_seedance",+ )+ memory_state = sm.MemoryState()+ error = seedance.VolcEngineSeedanceUnconfirmedTaskError(+ "remote state unknown", task_id="cgt-recover"+ )+ with (+ patch.object(task_service.sm, "state", memory_state),+ patch.object(task_service.material, "download_videos", side_effect=error),+ ):+ result = task_service.get_video_materials(+ task_id="seedance-material-error",+ params=params,+ video_terms=["scene"],+ audio_duration=5,+ )++ self.assertIsNone(result)+ failed = memory_state.get_task("seedance-material-error")+ self.assertEqual(failed["failed_stage"], "materials")+ self.assertEqual(failed["volcengine_seedance_task_id"], "cgt-recover")++ def test_task_records_remote_id_from_terminal_provider_error(self):+ params = VideoParams(+ video_subject="Seedance terminal failure",+ video_source="volcengine_seedance",+ )+ memory_state = sm.MemoryState()+ # 终态失败和协议异常使用基础错误类型。这里验证它们与“状态未知”+ # 异常保持同一恢复信息契约,不会在任务状态中丢失远端任务 ID。+ error = seedance.VolcEngineSeedanceError(+ "remote task failed", task_id="cgt-terminal"+ )+ with (+ patch.object(task_service.sm, "state", memory_state),+ patch.object(task_service.material, "download_videos", side_effect=error),+ ):+ result = task_service.get_video_materials(+ task_id="seedance-terminal-error",+ params=params,+ video_terms=["scene"],+ audio_duration=5,+ )++ self.assertIsNone(result)+ failed = memory_state.get_task("seedance-terminal-error")+ self.assertEqual(failed["failed_stage"], "materials")+ self.assertEqual(failed["volcengine_seedance_task_id"], "cgt-terminal")++ def test_task_records_paid_task_id_when_generated_video_download_fails(self):+ params = VideoParams(+ video_subject="Seedance download failure",+ video_source="volcengine_seedance",+ )+ memory_state = sm.MemoryState()+ error = seedance.VolcEngineSeedanceDownloadError(+ "generated video download failed",+ task_id="cgt-paid-result",+ )+ with (+ patch.object(task_service.sm, "state", memory_state),+ patch.object(task_service.material, "download_videos", side_effect=error),+ ):+ result = task_service.get_video_materials(+ task_id="seedance-download-error",+ params=params,+ video_terms=["scene"],+ audio_duration=5,+ )++ self.assertIsNone(result)+ failed = memory_state.get_task("seedance-download-error")+ self.assertEqual(failed["failed_stage"], "materials")+ self.assertEqual(failed["volcengine_seedance_task_id"], "cgt-paid-result")+++if __name__ == "__main__":+ unittest.main()diff --git a/test/services/test_webui_generation_defaults.py b/test/services/test_webui_generation_defaults.pyindex 3c9fe5d7..31e28b5d 100644--- a/test/services/test_webui_generation_defaults.py+++ b/test/services/test_webui_generation_defaults.py@@ -334,6 +334,33 @@ def test_invalid_saved_generation_settings_fall_back_without_breaking_webui():assert app.session_state["loomloom_video_scene_count"] == 1+def test_seedance_source_shows_unchecked_paid_task_confirmation():+ test_app_config = dict(+ config.app,+ video_source="volcengine_seedance",+ volcengine_seedance_api_key="",+ )+ test_ui_config = dict(+ config.ui,+ language="en",+ voice_mode="none",+ )++ with (+ patch.object(config, "app", test_app_config),+ patch.object(config, "ui", test_ui_config),+ patch.object(config, "save_config"),+ ):+ app = _new_app()++ assert _widget_by_key(app.selectbox, "video_source_select").value == (+ "volcengine_seedance"+ )+ assert _widget_by_key(+ app.checkbox, "volcengine_seedance_confirm_charge"+ ).value is False++def test_loomloom_tuning_survives_restart_without_persisting_payment_state():"""Paid-provider tuning is reusable; quotes and confirmations are not."""test_app_config = dict(diff --git a/test/services/test_webui_seedance.py b/test/services/test_webui_seedance.pynew file mode 100644index 00000000..d5b6cd71--- /dev/null+++ b/test/services/test_webui_seedance.py@@ -0,0 +1,62 @@+from pathlib import Path+from unittest.mock import patch++from streamlit.testing.v1 import AppTest++from app.config import config+++ROOT_DIR = Path(__file__).parent.parent.parent+WEBUI_MAIN = ROOT_DIR / "webui" / "Main.py"+++def _widget_by_key(elements, key):+ return next(+ item+ for item in elements+ if str(getattr(item, "key", "")) == key+ or str(getattr(item, "key", "")).startswith(f"{key}_")+ )+++def test_seedance_source_requires_confirmation_then_submits_without_secret_in_params():+ test_config = dict(+ config.app,+ llm_provider="openai",+ video_source="pexels",+ volcengine_seedance_api_key="ark-secret",+ )+ with (+ patch.object(config, "app", test_config),+ patch.object(config, "try_save_config", return_value=True),+ patch("app.services.webui_task.submit_generation") as submit_generation,+ ):+ app = AppTest.from_file(str(WEBUI_MAIN), default_timeout=60)+ app.session_state["ui_language"] = "en"+ app.run()++ _widget_by_key(app.text_area, "video_subject").set_value("AI office").run()+ _widget_by_key(app.text_area, "video_script").set_value(+ "AI helps people work faster."+ ).run()+ _widget_by_key(app.text_area, "video_terms").set_value(+ "office worker, AI assistant"+ ).run()+ _widget_by_key(app.selectbox, "video_source_select").select(+ "volcengine_seedance"+ ).run()++ _widget_by_key(app.button, "generate_video_button").click().run()+ assert submit_generation.call_count == 0+ assert any("confirm" in str(item.value).lower() for item in app.error)++ _widget_by_key(+ app.checkbox, "volcengine_seedance_confirm_charge"+ ).check().run()+ _widget_by_key(app.button, "generate_video_button").click().run()++ assert submit_generation.call_count == 1+ submitted_params = submit_generation.call_args.kwargs["params"]+ assert submitted_params.video_source == "volcengine_seedance"+ assert "ark-secret" not in submitted_params.model_dump_json()+ assert [str(item.value) for item in app.exception] == []diff --git a/test/services/test_webui_settings_transfer.py b/test/services/test_webui_settings_transfer.pyindex 4ca3e788..e31e0ee5 100644--- a/test/services/test_webui_settings_transfer.py+++ b/test/services/test_webui_settings_transfer.py@@ -122,6 +122,7 @@ def _sample_config_sections():"video_language": "en-US","upload_post_api_key": "api-key-123","upload_post_username": "my-username",+ "volcengine_seedance_api_key": "ark-seedance-key",},"azure": {"speech_key": "azure-key", "speech_region": "westeurope"},"elevenlabs": {"api_key": "eleven-key", "model_id": "eleven_v3"},@@ -221,11 +222,12 @@ def test_key_backup_collects_credentials_and_their_companion_settings():"cloudflare_gateway_id": "cf-gateway","upload_post_api_key": "api-key-123","upload_post_username": "my-username",+ "volcengine_seedance_api_key": "ark-seedance-key",},"azure": {"speech_key": "azure-key", "speech_region": "westeurope"},"elevenlabs": {"api_key": "eleven-key"},}- assert count_backup_keys(backup) == 10+ assert count_backup_keys(backup) == 11def test_key_backup_carries_llm_provider_extra_fields_with_the_key():@@ -279,6 +281,7 @@ def test_key_backup_round_trip_restores_every_saved_key():# Explicit assertion for upload_post credentials restoration requested by reviewerassert restored["app"]["upload_post_api_key"] == "api-key-123"assert restored["app"]["upload_post_username"] == "my-username"+ assert restored["app"]["volcengine_seedance_api_key"] == "ark-seedance-key"def test_key_backup_import_ignores_unknown_sections_and_non_key_settings():@@ -325,6 +328,9 @@ def test_credential_widget_state_keys_match_settings_inputs():assert credential_widget_state_keys("app", "openai_api_key") == ("openai_api_key_input",)+ assert credential_widget_state_keys("app", "volcengine_seedance_api_key") == (+ "volcengine_seedance_api_key_input",+ )assert credential_widget_state_keys("azure", "speech_key") == ("azure_speech_key_input",)diff --git a/webui/Main.py b/webui/Main.pyindex 349aee5e..513b7064 100644--- a/webui/Main.py+++ b/webui/Main.py@@ -48,6 +48,7 @@ from app.services import (llm,loomloom,video,+ volcengine_seedance,voice,webui_task,)@@ -532,6 +533,7 @@ def _initialize_session_state():"loomloom_video_client_request_id": "","loomloom_video_confirm_charge": False,"wavespeed_confirm_charge": False,+ "volcengine_seedance_confirm_charge": False,# AI 视频按素材段计费,默认只生成一段,用户确认效果后再主动增加数量。"loomloom_video_scene_count": _saved_ui_number("loomloom_video_scene_count",@@ -3012,6 +3014,44 @@ def _render_settings_dialog():)_save_material_api_keys("wavespeed_api_keys", wavespeed_api_key)+ seedance_api_key = st.text_input(+ tr("Volcano Engine Ark API Key"),+ value=str(config.app.get("volcengine_seedance_api_key", "") or ""),+ type="password",+ key="volcengine_seedance_api_key_input",+ )+ _set_runtime_config(+ "app", "volcengine_seedance_api_key", seedance_api_key.strip()+ )+ seedance_model = st.text_input(+ tr("Volcano Engine Seedance Model"),+ value=str(+ config.app.get(+ "volcengine_seedance_model",+ volcengine_seedance.DEFAULT_MODEL_ID,+ )+ or volcengine_seedance.DEFAULT_MODEL_ID+ ),+ key="volcengine_seedance_model_input",+ )+ _set_runtime_config(+ "app", "volcengine_seedance_model", seedance_model.strip()+ )+ seedance_base_url = st.text_input(+ tr("Volcano Engine Ark Base URL"),+ value=str(+ config.app.get(+ "volcengine_seedance_base_url",+ volcengine_seedance.DEFAULT_BASE_URL,+ )+ or volcengine_seedance.DEFAULT_BASE_URL+ ),+ key="volcengine_seedance_base_url_input",+ )+ _set_runtime_config(+ "app", "volcengine_seedance_base_url", seedance_base_url.strip()+ )+_save_runtime_config()@@ -3774,6 +3814,7 @@ def _render_video_settings(panel, params):(tr("Pixabay"), "pixabay"),(tr("Coverr"), "coverr"),(tr("WaveSpeed AI Video"), "wavespeed"),+ (tr("Volcano Engine Seedance"), "volcengine_seedance"),(tr("Shengsuan Cloud AI Video"), "loomloom"),(tr("Local file"), "local"),]@@ -3793,6 +3834,8 @@ def _render_video_settings(panel, params):if params.video_source == "wavespeed":st.caption(tr("WaveSpeed AI Video Help"))+ if params.video_source == "volcengine_seedance":+ st.caption(tr("Volcano Engine Seedance Help"))if params.video_source == "local":# Streamlit 的文件类型校验对扩展名大小写敏感,这里同时放行大小写两种形式。@@ -3990,6 +4033,8 @@ def _render_video_settings(panel, params):if params.video_source == "wavespeed":_render_wavespeed_video_settings(params)+ if params.video_source == "volcengine_seedance":+ _render_seedance_video_settings(params)return uploaded_files@@ -4025,6 +4070,32 @@ def _render_wavespeed_video_settings(params):)+def _render_seedance_video_settings(params):+ """展示预计付费任务数量,并要求用户明确确认方舟生成费用。"""+ clip_duration = max(int(params.video_clip_duration or 1), 1)+ video_count = max(int(params.video_count or 1), 1)+ estimated_range = _estimate_voiceover_duration_range(+ str(params.video_script or ""), params.voice_rate+ )+ if estimated_range:+ min_clips = max(math.ceil(estimated_range[0] * video_count / clip_duration), 1)+ max_clips = max(+ math.ceil(estimated_range[1] * video_count / clip_duration), min_clips+ )+ st.warning(+ tr("Volcano Engine Seedance Billing Notice").format(+ min=min_clips, max=max_clips+ )+ )+ else:+ st.warning(tr("Volcano Engine Seedance Billing Notice Without Script"))+ st.checkbox(+ tr("Confirm Volcano Engine Seedance Charge"),+ key="volcengine_seedance_confirm_charge",+ help=tr("Confirm Volcano Engine Seedance Charge Help"),+ )++def _estimate_voiceover_duration_range(text: str, voice_rate: float) -> tuple[float, float] | None:@@ -5696,6 +5767,7 @@ def _render_generation_controls("pixabay","coverr","wavespeed",+ "volcengine_seedance","loomloom","local",]:@@ -5738,6 +5810,22 @@ def _render_generation_controls(st.error(tr("Confirm WaveSpeed Charge Required"))st.stop()+ if params.video_source == "volcengine_seedance" and not (+ volcengine_seedance.is_enabled(+ config.snapshot_config_with_pending(config.app)+ )+ ):+ _remove_active_generation_task(task_id)+ st.error(tr("Please Enter the Volcano Engine Ark API Key"))+ st.stop()++ if params.video_source == "volcengine_seedance" and not st.session_state.get(+ "volcengine_seedance_confirm_charge", False+ ):+ _remove_active_generation_task(task_id)+ st.error(tr("Confirm Volcano Engine Seedance Charge Required"))+ st.stop()+loomloom_video_request = Noneif params.video_source == "loomloom":current_batch, current_signature = _current_loomloom_video_quote_context(diff --git a/webui/i18n/de.json b/webui/i18n/de.jsonindex 67741819..1340fe7d 100644--- a/webui/i18n/de.json+++ b/webui/i18n/de.json@@ -323,6 +323,17 @@"Confirm WaveSpeed Charge": "Ich verstehe, dass die WaveSpeed-Videogenerierung ein kostenpflichtiger Dienst ist","Confirm WaveSpeed Charge Help": "Clips werden bedarfsgesteuert Segment für Segment generiert; die Generierung stoppt, sobald das Material die Sprecherdauer abdeckt. Die Gebühren berechnet WaveSpeed pro generiertem Clip.","Confirm WaveSpeed Charge Required": "Bitte bestätigen Sie die WaveSpeed-Generierungskosten, bevor Sie das Video erstellen.",+ "Volcano Engine Seedance": "Volcano Engine Seedance",+ "Volcano Engine Seedance Help": "Erzeugen Sie neue Clips über die offizielle Volcano Engine Ark Seedance API. Jeder eingereichte Clip ist ein kostenpflichtiger Ark-Auftrag.",+ "Volcano Engine Ark API Key": "Volcano Engine Ark API-Schlüssel ([API-Schlüssel abrufen](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey))",+ "Volcano Engine Seedance Model": "Volcano Engine Seedance-Modell oder Endpoint-ID",+ "Volcano Engine Ark Base URL": "Volcano Engine Ark Base-URL",+ "Please Enter the Volcano Engine Ark API Key": "Bitte geben Sie den **Volcano Engine Ark API-Schlüssel** ein",+ "Volcano Engine Seedance Billing Notice": "Jeder erzeugte Clip wird von Volcano Engine Ark berechnet. Auf Grundlage der geschätzten Sprecher- und Clipdauer werden ungefähr {min}–{max} kostenpflichtige Aufträge übermittelt. Die Generierung endet, sobald genügend Material vorhanden ist.",+ "Volcano Engine Seedance Billing Notice Without Script": "Jeder erzeugte Clip wird von Volcano Engine Ark berechnet. Geben Sie ein Videoskript ein oder erzeugen Sie eines, um die geschätzte Anzahl der Aufträge anzuzeigen.",+ "Confirm Volcano Engine Seedance Charge": "Ich verstehe, dass die Seedance-Generierung kostenpflichtige Ark-Aufträge erstellt",+ "Confirm Volcano Engine Seedance Charge Help": "Seedance-Clips werden einzeln übermittelt, bis sie die Dauer der Sprachausgabe abdecken. Ark berechnet jeden eingereichten Generierungsauftrag.",+ "Confirm Volcano Engine Seedance Charge Required": "Bitte bestätigen Sie die Kosten der Volcano Engine Seedance-Generierung, bevor Sie das Video erstellen.","Auto-Publish Settings": "Automatisch veröffentlichen","Automatically publish generated videos to social media using upload-post.com": "Generierte Videos automatisch mit upload-post.com in sozialen Medien veröffentlichen","Enable Auto-Publish": "Automatisches Veröffentlichen aktivieren",diff --git a/webui/i18n/en.json b/webui/i18n/en.jsonindex bc3ade7b..56211bbc 100644--- a/webui/i18n/en.json+++ b/webui/i18n/en.json@@ -341,6 +341,17 @@"Confirm WaveSpeed Charge": "I understand WaveSpeed video generation is a paid service","Confirm WaveSpeed Charge Help": "Clips are generated on demand, one script segment at a time, and generation stops once the collected footage covers the voiceover duration. Fees are charged by WaveSpeed per generated clip.","Confirm WaveSpeed Charge Required": "Please confirm the WaveSpeed video generation charge before generating the video.",+ "Volcano Engine Seedance": "Volcano Engine Seedance",+ "Volcano Engine Seedance Help": "Generate brand-new clips through the official Volcano Engine Ark Seedance API. Each submitted clip is a paid Ark task.",+ "Volcano Engine Ark API Key": "Volcano Engine Ark API Key ([Get API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey))",+ "Volcano Engine Seedance Model": "Volcano Engine Seedance Model or Endpoint ID",+ "Volcano Engine Ark Base URL": "Volcano Engine Ark Base URL",+ "Please Enter the Volcano Engine Ark API Key": "Please enter the **Volcano Engine Ark API Key**",+ "Volcano Engine Seedance Billing Notice": "Each generated clip is billed by Volcano Engine Ark. Based on the estimated voiceover duration and clip duration, roughly {min}-{max} paid task(s) will be submitted. Generation stops as soon as enough footage is collected.",+ "Volcano Engine Seedance Billing Notice Without Script": "Each generated clip is billed by Volcano Engine Ark. Enter or generate the video script to see an estimated task count.",+ "Confirm Volcano Engine Seedance Charge": "I understand Volcano Engine Seedance generation creates paid Ark tasks",+ "Confirm Volcano Engine Seedance Charge Help": "Seedance clips are submitted one at a time and stop once they cover the voiceover duration. Ark bills each submitted generation task.",+ "Confirm Volcano Engine Seedance Charge Required": "Please confirm the Volcano Engine Seedance charge before generating the video.","Video Encoder": "Video Encoder","Default Video Encoder": "Default (Recommended)","Video Encoder Help": "Advanced option. Default follows the app's stable encoder policy, currently libx264. If a selected hardware encoder is unavailable, the app automatically falls back to libx264.",diff --git a/webui/i18n/es.json b/webui/i18n/es.jsonindex 2a5bbad9..7f265e36 100644--- a/webui/i18n/es.json+++ b/webui/i18n/es.json@@ -320,6 +320,17 @@"Confirm WaveSpeed Charge": "Entiendo que la generación de vídeo de WaveSpeed es un servicio de pago","Confirm WaveSpeed Charge Help": "Los clips se generan bajo demanda, segmento a segmento, y la generación se detiene cuando el material cubre la duración de la locución. WaveSpeed cobra por cada clip generado.","Confirm WaveSpeed Charge Required": "Por favor, confirma el coste de generación de WaveSpeed antes de generar el vídeo.",+ "Volcano Engine Seedance": "Volcano Engine Seedance",+ "Volcano Engine Seedance Help": "Genera clips nuevos mediante la API oficial Volcano Engine Ark Seedance. Cada clip enviado crea una tarea de pago en Ark.",+ "Volcano Engine Ark API Key": "Clave API de Volcano Engine Ark ([Obtener clave API](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey))",+ "Volcano Engine Seedance Model": "Modelo de Volcano Engine Seedance o ID del endpoint",+ "Volcano Engine Ark Base URL": "URL base de Volcano Engine Ark",+ "Please Enter the Volcano Engine Ark API Key": "Introduce la **clave API de Volcano Engine Ark**",+ "Volcano Engine Seedance Billing Notice": "Volcano Engine Ark cobra cada clip generado. Según la duración estimada de la narración y de los clips, se enviarán aproximadamente entre {min} y {max} tareas de pago. La generación se detiene en cuanto haya suficiente material.",+ "Volcano Engine Seedance Billing Notice Without Script": "Volcano Engine Ark cobra cada clip generado. Introduce o genera el guion del vídeo para ver una estimación del número de tareas.",+ "Confirm Volcano Engine Seedance Charge": "Entiendo que la generación con Volcano Engine Seedance crea tareas de pago en Ark",+ "Confirm Volcano Engine Seedance Charge Help": "Los clips de Seedance se envían uno a uno y se detienen cuando cubren la duración de la narración. Ark cobra cada tarea de generación enviada.",+ "Confirm Volcano Engine Seedance Charge Required": "Confirma el coste de generación de Volcano Engine Seedance antes de generar el vídeo.","Video Encoder": "Codificador de vídeo","Default Video Encoder": "Predeterminado (recomendado)","Video Encoder Help": "Opción avanzada. Predeterminado sigue la política estable de la aplicación, actualmente libx264. Si un codificador de hardware no está disponible, la aplicación vuelve automáticamente a libx264.",diff --git a/webui/i18n/fr.json b/webui/i18n/fr.jsonindex ae927580..6c11897a 100644--- a/webui/i18n/fr.json+++ b/webui/i18n/fr.json@@ -320,6 +320,17 @@"Confirm WaveSpeed Charge": "Je comprends que la génération vidéo WaveSpeed est un service payant","Confirm WaveSpeed Charge Help": "Les extraits sont générés à la demande, segment par segment, et la génération s'arrête une fois que les vidéos couvrent la durée de la voix off. Les frais sont facturés par WaveSpeed par extrait généré.","Confirm WaveSpeed Charge Required": "Veuillez confirmer les frais de génération vidéo WaveSpeed avant de lancer la vidéo.",+ "Volcano Engine Seedance": "Volcano Engine Seedance",+ "Volcano Engine Seedance Help": "Générez de nouveaux clips avec l’API officielle Volcano Engine Ark Seedance. Chaque clip soumis crée une tâche Ark payante.",+ "Volcano Engine Ark API Key": "Clé API Volcano Engine Ark ([Obtenir une clé API](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey))",+ "Volcano Engine Seedance Model": "Modèle Volcano Engine Seedance ou ID d’endpoint",+ "Volcano Engine Ark Base URL": "URL de base Volcano Engine Ark",+ "Please Enter the Volcano Engine Ark API Key": "Saisissez la **clé API Volcano Engine Ark**",+ "Volcano Engine Seedance Billing Notice": "Chaque clip généré est facturé par Volcano Engine Ark. D’après la durée estimée de la narration et des clips, environ {min} à {max} tâches payantes seront soumises. La génération s’arrête dès que suffisamment de séquences ont été obtenues.",+ "Volcano Engine Seedance Billing Notice Without Script": "Chaque clip généré est facturé par Volcano Engine Ark. Saisissez ou générez le script vidéo pour afficher une estimation du nombre de tâches.",+ "Confirm Volcano Engine Seedance Charge": "Je comprends que la génération Volcano Engine Seedance crée des tâches Ark payantes",+ "Confirm Volcano Engine Seedance Charge Help": "Les clips Seedance sont soumis un par un jusqu’à couvrir la durée de la narration. Ark facture chaque tâche de génération soumise.",+ "Confirm Volcano Engine Seedance Charge Required": "Veuillez confirmer les frais de génération Volcano Engine Seedance avant de créer la vidéo.","Video Encoder": "Encodeur vidéo","Default Video Encoder": "Par défaut (Recommandé)","Video Encoder Help": "Option avancée. Par défaut, utilise la stratégie d'encodage stable de l'application (actuellement libx264). Si un encodeur matériel sélectionné n'est pas disponible, l'application bascule automatiquement sur libx264.",diff --git a/webui/i18n/id.json b/webui/i18n/id.jsonindex 0ec50228..9676f74c 100644--- a/webui/i18n/id.json+++ b/webui/i18n/id.json@@ -320,6 +320,17 @@"Confirm WaveSpeed Charge": "Saya memahami bahwa pembuatan video WaveSpeed adalah layanan berbayar","Confirm WaveSpeed Charge Help": "Klip dibuat sesuai kebutuhan, segmen demi segmen, dan pembuatan berhenti begitu materi mencakup durasi sulih suara. Biaya ditagih WaveSpeed per klip yang dihasilkan.","Confirm WaveSpeed Charge Required": "Harap konfirmasi biaya pembuatan video WaveSpeed sebelum membuat video.",+ "Volcano Engine Seedance": "Volcano Engine Seedance",+ "Volcano Engine Seedance Help": "Buat klip baru melalui API resmi Volcano Engine Ark Seedance. Setiap klip yang dikirim merupakan tugas Ark berbayar.",+ "Volcano Engine Ark API Key": "Kunci API Volcano Engine Ark ([Dapatkan Kunci API](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey))",+ "Volcano Engine Seedance Model": "Model Volcano Engine Seedance atau ID endpoint",+ "Volcano Engine Ark Base URL": "URL Dasar Volcano Engine Ark",+ "Please Enter the Volcano Engine Ark API Key": "Masukkan **Kunci API Volcano Engine Ark**",+ "Volcano Engine Seedance Billing Notice": "Setiap klip yang dibuat dikenai biaya oleh Volcano Engine Ark. Berdasarkan perkiraan durasi narasi dan klip, sekitar {min}–{max} tugas berbayar akan dikirim. Pembuatan berhenti segera setelah materi mencukupi.",+ "Volcano Engine Seedance Billing Notice Without Script": "Setiap klip yang dibuat dikenai biaya oleh Volcano Engine Ark. Masukkan atau buat naskah video untuk melihat perkiraan jumlah tugas.",+ "Confirm Volcano Engine Seedance Charge": "Saya memahami bahwa pembuatan Volcano Engine Seedance menghasilkan tugas Ark berbayar",+ "Confirm Volcano Engine Seedance Charge Help": "Klip Seedance dikirim satu per satu dan berhenti setelah mencakup durasi narasi. Ark mengenakan biaya untuk setiap tugas pembuatan yang dikirim.",+ "Confirm Volcano Engine Seedance Charge Required": "Konfirmasikan biaya pembuatan Volcano Engine Seedance sebelum membuat video.","Video Encoder": "Encoder Video","Default Video Encoder": "Default (Direkomendasikan)","Video Encoder Help": "Opsi lanjutan. Default mengikuti kebijakan encoder stabil aplikasi, saat ini libx264. Jika encoder perangkat keras tidak tersedia, aplikasi otomatis kembali ke libx264.",diff --git a/webui/i18n/it.json b/webui/i18n/it.jsonindex a4b94cf0..e97fb01b 100644--- a/webui/i18n/it.json+++ b/webui/i18n/it.json@@ -320,6 +320,17 @@"Confirm WaveSpeed Charge": "Comprendo che la generazione video con WaveSpeed è un servizio a pagamento","Confirm WaveSpeed Charge Help": "I clip vengono generati su richiesta, un segmento del testo alla volta, e la generazione si interrompe quando il materiale raccolto copre la durata della voce fuori campo. WaveSpeed addebita ogni clip generato.","Confirm WaveSpeed Charge Required": "Conferma il costo della generazione video con WaveSpeed prima di generare il video.",+ "Volcano Engine Seedance": "Volcano Engine Seedance",+ "Volcano Engine Seedance Help": "Genera nuovi clip tramite l’API ufficiale Volcano Engine Ark Seedance. Ogni clip inviato crea un’attività Ark a pagamento.",+ "Volcano Engine Ark API Key": "Chiave API Volcano Engine Ark ([Ottieni chiave API](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey))",+ "Volcano Engine Seedance Model": "Modello Volcano Engine Seedance o ID endpoint",+ "Volcano Engine Ark Base URL": "URL di base Volcano Engine Ark",+ "Please Enter the Volcano Engine Ark API Key": "Inserisci la **chiave API Volcano Engine Ark**",+ "Volcano Engine Seedance Billing Notice": "Ogni clip generato viene addebitato da Volcano Engine Ark. In base alla durata stimata della narrazione e dei clip, verranno inviate circa {min}–{max} attività a pagamento. La generazione si arresta non appena il materiale è sufficiente.",+ "Volcano Engine Seedance Billing Notice Without Script": "Ogni clip generato viene addebitato da Volcano Engine Ark. Inserisci o genera lo script del video per visualizzare una stima del numero di attività.",+ "Confirm Volcano Engine Seedance Charge": "Comprendo che la generazione Volcano Engine Seedance crea attività Ark a pagamento",+ "Confirm Volcano Engine Seedance Charge Help": "I clip Seedance vengono inviati uno alla volta e si arrestano quando coprono la durata della narrazione. Ark addebita ogni attività di generazione inviata.",+ "Confirm Volcano Engine Seedance Charge Required": "Conferma il costo della generazione Volcano Engine Seedance prima di creare il video.","Video Encoder": "Codificatore video","Default Video Encoder": "Predefinito (consigliato)","Video Encoder Help": "Opzione avanzata. Il valore predefinito segue la politica di codifica stabile dell'applicazione, attualmente libx264. Se un codificatore hardware selezionato non è disponibile, l'applicazione torna automaticamente a libx264.",diff --git a/webui/i18n/ko.json b/webui/i18n/ko.jsonindex 6aed5d47..047539c1 100644--- a/webui/i18n/ko.json+++ b/webui/i18n/ko.json@@ -320,6 +320,17 @@"Confirm WaveSpeed Charge": "WaveSpeed 영상 생성이 유료 서비스임을 이해했습니다","Confirm WaveSpeed Charge Help": "클립은 스크립트 구간별로 필요할 때마다 생성되며, 수집된 영상이 음성 길이를 충족하면 생성이 중단됩니다. 요금은 생성된 클립당 WaveSpeed에서 청구됩니다.","Confirm WaveSpeed Charge Required": "영상을 생성하기 전에 WaveSpeed 영상 생성 요금에 동의해 주세요.",+ "Volcano Engine Seedance": "Volcano Engine Seedance",+ "Volcano Engine Seedance Help": "공식 Volcano Engine Ark Seedance API로 새로운 클립을 생성합니다. 제출하는 각 클립은 유료 Ark 작업입니다.",+ "Volcano Engine Ark API Key": "Volcano Engine Ark API 키 ([API 키 발급](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey))",+ "Volcano Engine Seedance Model": "Volcano Engine Seedance 모델 또는 엔드포인트 ID",+ "Volcano Engine Ark Base URL": "Volcano Engine Ark 기본 URL",+ "Please Enter the Volcano Engine Ark API Key": "**Volcano Engine Ark API 키**를 입력하세요",+ "Volcano Engine Seedance Billing Notice": "생성된 각 클립은 Volcano Engine Ark에서 과금됩니다. 예상 내레이션 길이와 클립 길이에 따라 약 {min}~{max}개의 유료 작업이 제출됩니다. 필요한 영상이 확보되면 즉시 생성을 중단합니다.",+ "Volcano Engine Seedance Billing Notice Without Script": "생성된 각 클립은 Volcano Engine Ark에서 과금됩니다. 예상 작업 수를 확인하려면 영상 대본을 입력하거나 생성하세요.",+ "Confirm Volcano Engine Seedance Charge": "Volcano Engine Seedance 생성이 유료 Ark 작업을 만든다는 것을 이해했습니다",+ "Confirm Volcano Engine Seedance Charge Help": "Seedance 클립은 하나씩 제출되며 내레이션 길이를 채우면 중단됩니다. Ark는 제출된 각 생성 작업에 요금을 부과합니다.",+ "Confirm Volcano Engine Seedance Charge Required": "영상을 생성하기 전에 Volcano Engine Seedance 생성 요금을 확인해 주세요.","Video Encoder": "영상 인코더","Default Video Encoder": "기본값 (권장)","Video Encoder Help": "고급 옵션입니다. 기본값은 앱의 안정적인 인코더 정책(현재 libx264)을 따릅니다. 선택한 하드웨어 인코더를 사용할 수 없으면 자동으로 libx264로 대체됩니다.",diff --git a/webui/i18n/pt.json b/webui/i18n/pt.jsonindex 35b09298..e8115537 100644--- a/webui/i18n/pt.json+++ b/webui/i18n/pt.json@@ -320,6 +320,17 @@"Confirm WaveSpeed Charge": "Entendo que a geração de vídeo da WaveSpeed é um serviço pago","Confirm WaveSpeed Charge Help": "Os clipes são gerados sob demanda, segmento a segmento, e a geração para quando o material cobre a duração da narração. A WaveSpeed cobra por clipe gerado.","Confirm WaveSpeed Charge Required": "Confirme o custo de geração da WaveSpeed antes de gerar o vídeo.",+ "Volcano Engine Seedance": "Volcano Engine Seedance",+ "Volcano Engine Seedance Help": "Gere novos clipes pela API oficial Volcano Engine Ark Seedance. Cada clipe enviado cria uma tarefa Ark paga.",+ "Volcano Engine Ark API Key": "Chave de API do Volcano Engine Ark ([Obter chave de API](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey))",+ "Volcano Engine Seedance Model": "Modelo Volcano Engine Seedance ou ID do endpoint",+ "Volcano Engine Ark Base URL": "URL base do Volcano Engine Ark",+ "Please Enter the Volcano Engine Ark API Key": "Insira a **chave de API do Volcano Engine Ark**",+ "Volcano Engine Seedance Billing Notice": "Cada clipe gerado é cobrado pelo Volcano Engine Ark. Com base na duração estimada da narração e dos clipes, serão enviadas aproximadamente {min}–{max} tarefas pagas. A geração termina assim que houver material suficiente.",+ "Volcano Engine Seedance Billing Notice Without Script": "Cada clipe gerado é cobrado pelo Volcano Engine Ark. Insira ou gere o roteiro do vídeo para ver uma estimativa do número de tarefas.",+ "Confirm Volcano Engine Seedance Charge": "Entendo que a geração Volcano Engine Seedance cria tarefas Ark pagas",+ "Confirm Volcano Engine Seedance Charge Help": "Os clipes Seedance são enviados um por vez até cobrirem a duração da narração. O Ark cobra cada tarefa de geração enviada.",+ "Confirm Volcano Engine Seedance Charge Required": "Confirme o custo da geração Volcano Engine Seedance antes de criar o vídeo.","Video Encoder": "Codificador de vídeo","Default Video Encoder": "Padrão (recomendado)","Video Encoder Help": "Opção avançada. Padrão segue a política estável do aplicativo, atualmente libx264. Se um codificador de hardware não estiver disponível, o aplicativo retorna automaticamente para libx264.",diff --git a/webui/i18n/ru.json b/webui/i18n/ru.jsonindex cd288926..738a3840 100644--- a/webui/i18n/ru.json+++ b/webui/i18n/ru.json@@ -316,6 +316,17 @@"Confirm WaveSpeed Charge": "Я понимаю, что генерация видео WaveSpeed — платная услуга","Confirm WaveSpeed Charge Help": "Клипы генерируются по требованию, сегмент за сегментом; генерация останавливается, когда материал покрывает длительность озвучки. WaveSpeed взимает плату за каждый сгенерированный клип.","Confirm WaveSpeed Charge Required": "Пожалуйста, подтвердите стоимость генерации WaveSpeed перед созданием видео.",+ "Volcano Engine Seedance": "Volcano Engine Seedance",+ "Volcano Engine Seedance Help": "Создавайте новые клипы через официальный API Volcano Engine Ark Seedance. Каждый отправленный клип является платной задачей Ark.",+ "Volcano Engine Ark API Key": "API-ключ Volcano Engine Ark ([Получить API-ключ](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey))",+ "Volcano Engine Seedance Model": "Модель Volcano Engine Seedance или ID эндпоинта",+ "Volcano Engine Ark Base URL": "Базовый URL Volcano Engine Ark",+ "Please Enter the Volcano Engine Ark API Key": "Введите **API-ключ Volcano Engine Ark**",+ "Volcano Engine Seedance Billing Notice": "Каждый созданный клип оплачивается в Volcano Engine Ark. С учётом предполагаемой длительности озвучки и клипов будет отправлено примерно {min}–{max} платных задач. Генерация остановится, как только материала будет достаточно.",+ "Volcano Engine Seedance Billing Notice Without Script": "Каждый созданный клип оплачивается в Volcano Engine Ark. Введите или создайте сценарий видео, чтобы увидеть примерное количество задач.",+ "Confirm Volcano Engine Seedance Charge": "Я понимаю, что генерация Volcano Engine Seedance создаёт платные задачи Ark",+ "Confirm Volcano Engine Seedance Charge Help": "Клипы Seedance отправляются по одному, пока не покроют длительность озвучки. Ark взимает плату за каждую отправленную задачу генерации.",+ "Confirm Volcano Engine Seedance Charge Required": "Подтвердите стоимость генерации Volcano Engine Seedance перед созданием видео.","Video Encoder": "Видеокодер","Default Video Encoder": "По умолчанию (рекомендуется)","Video Encoder Help": "Дополнительная настройка. Значение по умолчанию следует стабильной политике приложения, сейчас это libx264. Если аппаратный кодер недоступен, приложение автоматически вернется к libx264.",diff --git a/webui/i18n/tr.json b/webui/i18n/tr.jsonindex ae2c0714..ba5c9db6 100644--- a/webui/i18n/tr.json+++ b/webui/i18n/tr.json@@ -320,6 +320,17 @@"Confirm WaveSpeed Charge": "WaveSpeed video üretiminin ücretli bir hizmet olduğunu anlıyorum","Confirm WaveSpeed Charge Help": "Klipler ihtiyaç oldukça, senaryo bölümü bölümü üretilir; görüntüler seslendirme süresini karşıladığında üretim durur. Ücretler, üretilen klip başına WaveSpeed tarafından alınır.","Confirm WaveSpeed Charge Required": "Lütfen videoyu oluşturmadan önce WaveSpeed üretim ücretini onaylayın.",+ "Volcano Engine Seedance": "Volcano Engine Seedance",+ "Volcano Engine Seedance Help": "Resmî Volcano Engine Ark Seedance API’siyle yeni klipler oluşturun. Gönderilen her klip ücretli bir Ark görevidir.",+ "Volcano Engine Ark API Key": "Volcano Engine Ark API Anahtarı ([API Anahtarı Al](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey))",+ "Volcano Engine Seedance Model": "Volcano Engine Seedance modeli veya endpoint kimliği",+ "Volcano Engine Ark Base URL": "Volcano Engine Ark Temel URL’si",+ "Please Enter the Volcano Engine Ark API Key": "Lütfen **Volcano Engine Ark API Anahtarını** girin",+ "Volcano Engine Seedance Billing Notice": "Oluşturulan her klip Volcano Engine Ark tarafından ücretlendirilir. Tahmini seslendirme ve klip süresine göre yaklaşık {min}–{max} ücretli görev gönderilir. Yeterli görüntü elde edildiğinde üretim durur.",+ "Volcano Engine Seedance Billing Notice Without Script": "Oluşturulan her klip Volcano Engine Ark tarafından ücretlendirilir. Tahmini görev sayısını görmek için video metnini girin veya oluşturun.",+ "Confirm Volcano Engine Seedance Charge": "Volcano Engine Seedance üretiminin ücretli Ark görevleri oluşturduğunu anlıyorum",+ "Confirm Volcano Engine Seedance Charge Help": "Seedance klipleri tek tek gönderilir ve seslendirme süresini karşıladığında durur. Ark, gönderilen her üretim görevi için ücret alır.",+ "Confirm Volcano Engine Seedance Charge Required": "Videoyu oluşturmadan önce Volcano Engine Seedance üretim ücretini onaylayın.","Video Encoder": "Video Kodlayıcı","Default Video Encoder": "Varsayılan (Önerilen)","Video Encoder Help": "Gelişmiş seçenek. Varsayılan, uygulamanın kararlı kodlayıcı politikasını izler; şu anda libx264 kullanılır. Donanım kodlayıcı kullanılamıyorsa uygulama otomatik olarak libx264'e döner.",diff --git a/webui/i18n/vi.json b/webui/i18n/vi.jsonindex 44505120..deea7e9f 100644--- a/webui/i18n/vi.json+++ b/webui/i18n/vi.json@@ -320,6 +320,17 @@"Confirm WaveSpeed Charge": "Tôi hiểu rằng tạo video bằng WaveSpeed là dịch vụ trả phí","Confirm WaveSpeed Charge Help": "Các đoạn video được tạo theo nhu cầu, từng phân đoạn một; việc tạo dừng khi tư liệu đã đủ cho thời lượng thuyết minh. WaveSpeed tính phí theo từng đoạn được tạo.","Confirm WaveSpeed Charge Required": "Vui lòng xác nhận chi phí tạo video WaveSpeed trước khi tạo video.",+ "Volcano Engine Seedance": "Volcano Engine Seedance",+ "Volcano Engine Seedance Help": "Tạo clip mới qua API Volcano Engine Ark Seedance chính thức. Mỗi clip được gửi là một tác vụ Ark có tính phí.",+ "Volcano Engine Ark API Key": "Khóa API Volcano Engine Ark ([Lấy khóa API](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey))",+ "Volcano Engine Seedance Model": "Mô hình Volcano Engine Seedance hoặc ID endpoint",+ "Volcano Engine Ark Base URL": "URL cơ sở Volcano Engine Ark",+ "Please Enter the Volcano Engine Ark API Key": "Vui lòng nhập **Khóa API Volcano Engine Ark**",+ "Volcano Engine Seedance Billing Notice": "Mỗi clip được tạo đều bị Volcano Engine Ark tính phí. Dựa trên thời lượng lồng tiếng và thời lượng clip ước tính, khoảng {min}–{max} tác vụ có tính phí sẽ được gửi. Quá trình tạo dừng ngay khi đã có đủ cảnh quay.",+ "Volcano Engine Seedance Billing Notice Without Script": "Mỗi clip được tạo đều bị Volcano Engine Ark tính phí. Nhập hoặc tạo kịch bản video để xem số tác vụ ước tính.",+ "Confirm Volcano Engine Seedance Charge": "Tôi hiểu rằng việc tạo bằng Volcano Engine Seedance sẽ tạo các tác vụ Ark có tính phí",+ "Confirm Volcano Engine Seedance Charge Help": "Các clip Seedance được gửi lần lượt và dừng khi đã đủ thời lượng lồng tiếng. Ark tính phí cho từng tác vụ tạo được gửi.",+ "Confirm Volcano Engine Seedance Charge Required": "Vui lòng xác nhận chi phí tạo Volcano Engine Seedance trước khi tạo video.","Video Encoder": "Bộ Mã Hóa Video","Default Video Encoder": "Mặc định (Khuyên dùng)","Video Encoder Help": "Tùy chọn nâng cao. Mặc định tuân theo chính sách mã hóa ổn định của ứng dụng, hiện là libx264. Nếu bộ mã hóa phần cứng không khả dụng, ứng dụng tự động chuyển về libx264.",diff --git a/webui/i18n/zh.json b/webui/i18n/zh.jsonindex c0bdeb8c..2cb44fca 100644--- a/webui/i18n/zh.json+++ b/webui/i18n/zh.json@@ -341,6 +341,17 @@"Confirm WaveSpeed Charge": "我已了解 WaveSpeed 视频生成为付费服务","Confirm WaveSpeed Charge Help": "素材按脚本片段逐段按需生成,凑够配音所需时长后立即停止,不会为用不到的片段付费。费用由 WaveSpeed 按实际生成条数结算。","Confirm WaveSpeed Charge Required": "请确认 WaveSpeed 视频生成费用后再生成视频。",+ "Volcano Engine Seedance": "火山引擎 Seedance",+ "Volcano Engine Seedance Help": "通过火山方舟官方 Seedance API 按脚本关键词生成全新视频素材。每段素材都会创建一个付费方舟任务。",+ "Volcano Engine Ark API Key": "火山方舟 API Key([获取 API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apikey))",+ "Volcano Engine Seedance Model": "火山引擎 Seedance 模型或推理接入点 ID",+ "Volcano Engine Ark Base URL": "火山方舟 Base URL",+ "Please Enter the Volcano Engine Ark API Key": "请输入 **火山方舟 API Key**",+ "Volcano Engine Seedance Billing Notice": "每段生成视频都会由火山方舟计费。根据预计配音时长和片段时长,将提交约 {min}-{max} 个付费任务;凑够所需素材后会立即停止。",+ "Volcano Engine Seedance Billing Notice Without Script": "每段生成视频都会由火山方舟计费。填写或生成视频文案后可查看预计任务数量。",+ "Confirm Volcano Engine Seedance Charge": "我已了解火山引擎 Seedance 会创建付费方舟任务",+ "Confirm Volcano Engine Seedance Charge Help": "Seedance 素材按脚本片段逐段提交,凑够配音所需时长后立即停止。火山方舟按实际提交的生成任务计费。",+ "Confirm Volcano Engine Seedance Charge Required": "请确认火山引擎 Seedance 生成费用后再生成视频。","Video Encoder": "视频编码器","Default Video Encoder": "默认(推荐)","Video Encoder Help": "高级选项。“默认”跟随项目的稳定编码策略,当前使用 libx264;选择硬件编码器时,如果当前 FFmpeg、显卡或驱动不可用,会自动回退到 libx264。",