kangwan/20260512-skg-tk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

auto-save 2026-05-14 13:32 (~4)

Browse Source
This commit is contained in:
kang
2026-05-14 13:32:50 +08:00
parent 00435b21ae
commit 31cb874028
4 changed files with 59 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files

17
docs/source-analysis.html
View File

@@ -919,6 +919,19 @@ SubjectAsset {
<h2>变更记录</h2>
<p>这个记录不是 git log 的替代品。它记录“产品理解发生了什么变化、影响了哪些源码、你以后描述需求时该怎么说”。后续每次改功能都要补一条。</p>
<div class="changelog">
<article class="change">
<header>
<h3>2026-05-14 · 修正 SKG 豆包视频网关路径</h3>
<span class="tag orange">Video Gen</span>
<span class="tag blue">Seedance</span>
</header>
<div class="body">
<p><strong>问题：</strong>产品融合视频能进入队列，但后台任务 5% 后失败，错误为 <code>/contents/generations/tasks</code> 返回 404。</p>
<p><strong>根因：</strong><code>https://ai.skg.com/doubao</code> 这个 SKG 豆包网关的真实视频入口是 <code>/api/v3/contents/generations/tasks</code>，不是火山方舟直连 base 下使用的 <code>/contents/generations/tasks</code>。</p>
<p><strong>改动：</strong>后端默认路径识别 <code>ai.skg.com/doubao</code> 并自动使用 <code>/api/v3/contents/generations/tasks</code>、<code>/api/v3/contents/generations/tasks/{id}</code>、<code>/api/v3/contents/generations/tasks/{id}/content</code>；本机 <code>api/.env</code> 和 <code>api/.env.example</code> 同步更新。</p>
<p><strong>影响：</strong><code>api/main.py</code>、<code>api/.env</code>、<code>api/.env.example</code>、<code>docs/source-analysis.html</code>。</p>
</div>
</article>
<article class="change">
<header>
<h3>2026-05-14 · 产品融合改为内置角色 + 产品 + 描述生成</h3>
@@ -1076,7 +1089,7 @@ SubjectAsset {
</header>
<div class="body">
<p><strong>问题：</strong>用户提供 <code>https://ai.skg.com/doubao</code> 作为视频模型网关；该网关应按 Seedance / 方舟内容生成任务格式提交，而不能误走普通 multipart 上传。</p>
<p><strong>改动：</strong><code>video_uses_ark()</code> 现在同时识别火山方舟域名和 <code>ai.skg.com/doubao</code>，统一使用 <code>content</code> JSON：文本 prompt、首帧、尾帧和产品参考图作为不同 role 传入，再按 <code>/contents/generations/tasks/{id}</code> 轮询。<code>api/.env.example</code> 增加 SKG 豆包视频网关配置示例；生视频轮询上限改为 <code>VIDEO_POLL_TIMEOUT_SECONDS</code>，默认 900 秒，避免慢任务过早失败。</p>
<p><strong>改动：</strong><code>video_uses_ark()</code> 现在同时识别火山方舟域名和 <code>ai.skg.com/doubao</code>，统一使用 <code>content</code> JSON：文本 prompt、首帧、尾帧和产品参考图作为不同 role 传入。火山方舟直连按 <code>/contents/generations/tasks/{id}</code> 轮询；SKG 豆包网关按 <code>/api/v3/contents/generations/tasks/{id}</code> 轮询。<code>api/.env.example</code> 增加 SKG 豆包视频网关配置示例；生视频轮询上限改为 <code>VIDEO_POLL_TIMEOUT_SECONDS</code>，默认 900 秒，避免慢任务过早失败。</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=https://ai.skg.com/doubao</code> 和视频专用 key。</p>
</div>
</article>
@@ -1696,7 +1709,7 @@ SubjectAsset {
</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。本机默认 Seedance 模型改为 Ark 可见的 <code>doubao-seedance-2-0-fast-260128</code>。</p>
<p><strong>改动：</strong>后端识别 Ark base 后，提交改为内容生成任务接口，火山方舟直连使用 <code>POST /contents/generations/tasks</code>，SKG 豆包网关使用 <code>POST /api/v3/contents/generations/tasks</code>。请求体使用 <code>content</code> 数组：文本 prompt + 首帧 <code>image_url</code> data URL；轮询对应的 <code>{id}</code> 任务地址，成功后读取 <code>content.video_url</code> 下载 MP4。本机默认 Seedance 模型改为 Ark 可见的 <code>doubao-seedance-2-0-fast-260128</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> 需要把 <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>