auto-save 2026-05-13 21:07 (~4)

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：模型层按业务保留 Seedance / Kling / Veo/Voe 选择；网关调用层通过 <code>VIDEO_CREATE_PATHS</code> 多入口尝试，当前常见入口实测返回 404/unsupported，若平台后台有其它入口要直接配置到该变量。</li>
+              <li>Video Gen：模型层按业务保留 Seedance / Kling / Veo/Voe 选择；后端已支持 Poe 视频通道，别名默认映射到 <code>seedance-2-fast</code>、<code>kling-omni</code>、<code>veo-3.1-fast</code>，提交后写入 Video Gen 节点。</li>
               <li>Compose：还没做本地 ffmpeg 字幕/TTS 合成。</li>
             </ul>
           </div>
@@ -830,6 +830,30 @@ api/main.py
         <h2>变更记录</h2>
         <p>这个记录不是 git log 的替代品。它记录“产品理解发生了什么变化、影响了哪些源码、你以后描述需求时该怎么说”。后续每次改功能都要补一条。</p>
         <div class="changelog">
+          <article class="change">
+            <header>
+              <h3>2026-05-13 · 生视频支持火山方舟 Ark 异步任务</h3>
+              <span class="tag rose">VideoGenNode</span>
+              <span class="tag blue">API</span>
+            </header>
+            <div class="body">
+              <p><strong>问题：</strong>用户提供火山方舟 <code>https://ark.cn-beijing.volces.com/api/v3</code> 作为生视频通道；这个通道不是 Poe 的 <code>/videos</code> 形态，而是内容生成异步任务。</p>
+              <p><strong>改动：</strong>后端识别 Ark base 后，提交改为 <code>POST /contents/generations/tasks</code>，请求体使用 <code>content</code> 数组：文本 prompt + 首帧 <code>image_url</code> data URL；轮询改为 <code>GET /contents/generations/tasks/{id}</code>，成功后读取 <code>content.video_url</code> 下载 MP4。</p>
+              <p><strong>影响：</strong><code>api/main.py</code>、<code>api/.env.example</code>、<code>docs/source-analysis.html</code>。本机 <code>api/.env</code> 需要把 <code>VIDEO_API_BASE_URL</code>/<code>VIDEO_API_KEY</code>/<code>VIDEO_CREATE_PATHS</code>/<code>VIDEO_STATUS_PATH</code> 指向 Ark。</p>
+            </div>
+          </article>
+          <article class="change">
+            <header>
+              <h3>2026-05-13 · 生视频改接 Poe 视频模型</h3>
+              <span class="tag rose">VideoGenNode</span>
+              <span class="tag blue">API</span>
+            </header>
+            <div class="body">
+              <p><strong>问题：</strong>SKG ezlink 的 OpenAI 兼容 base 可列出部分模型，但常规 <code>/videos</code> 入口返回 404/unsupported；用户确认可用的视频模型在 Poe 通道里。</p>
+              <p><strong>改动：</strong>后端新增 <code>POE_API_BASE_URL</code>/<code>POE_API_KEY</code> 配置，未显式配置 <code>VIDEO_API_BASE_URL</code> 时优先走 Poe；Seedance / Kling / Veo/Voe 业务别名默认映射到 Poe 真实模型 <code>seedance-2-fast</code>、<code>kling-omni</code>、<code>veo-3.1-fast</code>。Poe 提交使用 <code>input_image</code> base64，继续轮询 <code>/videos/{id}</code> 并下载 <code>/videos/{id}/content</code>。</p>
+              <p><strong>影响：</strong><code>api/main.py</code>、<code>api/.env.example</code>、<code>docs/source-analysis.html</code>。密钥只放本地 <code>api/.env</code>，不进入源码解析页。</p>
+            </div>
+          </article>
           <article class="change">
             <header>
               <h3>2026-05-13 · 生视频提交不再被前端锁死</h3>