auto-save 2026-05-13 20:56 (~7)

docs/source-analysis.html

@@ -790,7 +790,7 @@ api/main.py
               <li>ASR：SKG 网关 audio endpoint 404 或渠道不可用。</li>
               <li>Translate：本身 text 通，但产品流里依赖 ASR 段落。</li>
               <li>Rewrite：需要 SKG 产品信息模板和目标脚本结构。</li>
-              <li>Video Gen：当前 SKG ezlink 未开 <code>/videos</code>（实测 404，<code>/models</code> 只列 <code>sora-2</code>）；代码已支持通过 <code>VIDEO_API_BASE_URL</code>/<code>VIDEO_API_KEY</code> 显式接 Seedance / Kling / Veo 3 外部生视频 API，未配置时会前置报错，不再生成 5% 失败任务。</li>
+              <li>Video Gen：模型层按业务保留 Seedance / Kling / Veo/Voe 选择；网关调用层通过 <code>VIDEO_CREATE_PATHS</code> 多入口尝试，当前常见入口实测返回 404/unsupported，若平台后台有其它入口要直接配置到该变量。</li>
               <li>Compose：还没做本地 ffmpeg 字幕/TTS 合成。</li>
             </ul>
           </div>
@@ -832,14 +832,14 @@ api/main.py
         <div class="changelog">
           <article class="change">
             <header>
-              <h3>2026-05-13 · 视频 API 未开通时前置禁用按钮</h3>
+              <h3>2026-05-13 · 生视频提交不再被前端锁死</h3>
               <span class="tag violet">StoryboardWorkbench</span>
-              <span class="tag blue">Health</span>
+              <span class="tag blue">API</span>
             </header>
             <div class="body">
-              <p><strong>问题：</strong>当前 SKG ezlink 未开 <code>/videos</code>，用户点生成后才看到失败 toast，容易误以为是某个分镜或模型选择错误。</p>
-              <p><strong>改动：</strong>前端启动时读取 <code>/health</code> 的 <code>models.video_configured</code>；若为 false，分镜编排的生视频区域直接显示“视频 API 未开通”，并禁用提交按钮。</p>
-              <p><strong>影响：</strong><code>web/lib/api.ts</code>、<code>web/app/page.tsx</code>、<code>web/components/storyboard-workbench.tsx</code>。</p>
+              <p><strong>问题：</strong>虽然当前探测到常见视频入口返回 404/unsupported，但模型层确实有视频模型，不能在前端简单判定“未开通”并禁用。</p>
+              <p><strong>改动：</strong>撤掉分镜编排里的前置禁用；后端允许提交 seedance / kling / veo / voe，并支持通过 <code>VIDEO_CREATE_PATHS</code> 逗号分隔配置多个候选生成入口，逐个尝试。</p>
+              <p><strong>影响：</strong><code>api/main.py</code>、<code>api/.env.example</code>、<code>web/app/page.tsx</code>、<code>web/components/storyboard-workbench.tsx</code>。</p>
             </div>
           </article>
           <article class="change">
@@ -850,7 +850,7 @@ api/main.py
             </header>
             <div class="body">
               <p><strong>问题：</strong>提交生视频失败时，前端把 <code>generateStoryboardVideo 503 {"detail": ...}</code> 原样展示，用户无法快速判断是配置、端点还是 UI 问题。</p>
-              <p><strong>改动：</strong><code>generateStoryboardVideo</code> 解析后端 JSON 的 <code>detail</code> 后再抛错；后端 503 文案改为“SKG ezlink 已连通但当前 key 未开 /videos”；Video Gen 失败卡把 <code>/videos 404</code> 长错误压缩成一句可读原因。</p>
+              <p><strong>改动：</strong><code>generateStoryboardVideo</code> 解析后端 JSON 的 <code>detail</code> 后再抛错；后端错误文案区分“模型存在”和“入口不可用”；Video Gen 失败卡把 <code>/videos 404</code> 长错误压缩成一句可读原因。</p>
               <p><strong>影响：</strong><code>web/lib/api.ts</code>、<code>web/components/nodes/index.tsx</code>、<code>api/main.py</code>。</p>
             </div>
           </article>
@@ -874,7 +874,7 @@ api/main.py
             </header>
             <div class="body">
               <p><strong>问题：</strong>4 图槽已经粘贴参考图后，用户要直接调用生视频 API，而不是只生成 prompt 或图片任务。</p>
-              <p><strong>改动：</strong>分镜编排明细区增加 Seedance / Kling / Veo 3 模型选择和“调用模型生成视频”按钮；后端新增 <code>/jobs/{job_id}/frames/{idx}/storyboard/video</code>。若已配置真实 <code>VIDEO_API_BASE_URL</code>，则提交、轮询并保存 MP4；若仍使用当前 SKG ezlink，则前置返回 503，避免继续创建 404 失败任务。<code>VideoGenNode</code> 读取 <code>job.generated_videos</code> 展示排队、生成中、失败和完成视频。</p>
+              <p><strong>改动：</strong>分镜编排明细区增加 Seedance / Kling / Veo 3 模型选择和“调用模型生成视频”按钮；后端新增 <code>/jobs/{job_id}/frames/{idx}/storyboard/video</code>。提交后按 <code>VIDEO_CREATE_PATHS</code> 逐个尝试生成入口，成功后轮询并保存 MP4；失败时保留任务卡和具体入口错误，方便继续排查网关实际路径。<code>VideoGenNode</code> 读取 <code>job.generated_videos</code> 展示排队、生成中、失败和完成视频。</p>
               <p><strong>影响：</strong><code>api/main.py</code>、<code>api/.env.example</code>、<code>web/components/storyboard-workbench.tsx</code>、<code>web/components/nodes/index.tsx</code>、<code>web/app/page.tsx</code>、<code>web/lib/api.ts</code>。Sora 不再作为默认模型；真实模型 ID 通过 <code>VIDEO_MODEL_SEEDANCE</code>、<code>VIDEO_MODEL_KLING</code>、<code>VIDEO_MODEL_VEO3</code> 配置，真实视频 API 地址通过 <code>VIDEO_API_BASE_URL</code>/<code>VIDEO_API_KEY</code> 配置。</p>
             </div>
           </article>