@q253595422/dsh-imagegen-video 1.19.1 → 1.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -5,6 +5,28 @@ Attribution for third-party code is in [NOTICE](./NOTICE).
5
5
 
6
6
  ## Releases
7
7
 
8
+ ### 1.20.0 — 接入 snapgen.ai 视频模型
9
+
10
+ - **新增 snapgen.ai 视频协议族。** 渠道预设新增 `snapgen.ai`,支持 `grok-1.5-lite`、`grok-video`、
11
+ `grok-lower`、`muse-ai-video`、`vela-ai-video` 五个模型。该服务不是 OpenAI 兼容接口:提交是
12
+ multipart 加自研反爬守卫头 `x-guard-id`,返回历史 uuid 而不是任务 id,状态接口 `GET /history/{uuid}`
13
+ 用数字状态(1 生成中 / 2 完成 / 3 失败),成片地址在 `generated_video[0].video_url`。这四条都在
14
+ `src/snapgen-engine.ts` 里单独实现,`video-engine.ts` 只负责编排。
15
+ - **密钥填 refresh_token,Access Token 自动续期。** Access Token 只有约 10 分钟有效期,过期时上游
16
+ 返回的是 HTTP 403 `TOKEN_EXPIRED` 而不是 401,所以引擎按 JWT `exp` 提前续期,并在收到带 TOKEN
17
+ 字样的 403 时强制刷新后重试一次。密钥栏接受原始 refresh_token、`{"refresh_token":"…","cdp_port":9333}`
18
+ 形式的 JSON,或一枚仍在有效期内的 access_token。
19
+ - **每次提交现场换取一次性 Cloudflare Turnstile token。** 上游强制校验,token 一次性且绑定 site key,
20
+ 无法缓存或本地计算,因此通过本机 CDP Chrome(默认端口 9333,无头亦可)在真实 snapgen.ai 页面上换取。
21
+ - **按模型区分能力。** 时长与比例词表按模型收窄后渲染:`grok-*` 为 6/10/15 秒,`muse-ai-video` 固定
22
+ 10 秒,`vela-ai-video` 固定 5 秒;五个模型都支持文生视频,`muse`/`vela` 另有图生视频。视频面板与画布
23
+ 的时长、比例、分辨率选项改为读目录数据,不再写死 `[5, 10]`。
24
+ - **只有视频模型的渠道可以保存了。** 以前渠道至少需要一个图片模型标识才能保存,只接视频的 snapgen
25
+ 渠道因此存不下来;校验与「已就绪」判定改为图片或视频模型任一非空即可。
26
+ - **验证**:`tsc` 0 错;离线冒烟新增两组断言(守卫字节与实测值逐字节对齐、提交前失败不触网),
27
+ `smoke-video.mjs` 33 项全过;通过插件本体对 api.snapgen.ai 实跑成功出片:文生视频 10 秒 4.3 MB、
28
+ 图生视频 10 秒 7.7 MB,均为 h264 + aac 的有效 MP4。
29
+
8
30
  ### 1.19.1 — 修正历史提示词换行展示位置
9
31
 
10
32
  - **左侧边栏历史卡片恢复 2 行截断。** 修复之前误将左侧卡片提示词取消截断导致长文本撑高卡片、
package/README.md CHANGED
@@ -188,6 +188,7 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-X.Y.Z.tgz
188
188
  | 火山 Seedance(方舟) | `doubao-seedance-2-0-260128`、`doubao-seedance-2-0-fast-260128`、`doubao-seedance-1-0-pro-250528` | 方舟原生任务协议:提交 `POST /contents/generations/tasks`,轮询 `GET /contents/generations/tasks/{id}`,成片在 `content.video_url`。提示词与参考图放在 `content` 数组里(参考图带 `role`:`first_frame` / `last_frame` / `reference_image`),比例字段是 `ratio`,分辨率小写。时长:2.x 为 4–15 秒、1.0 为 2–12 秒。分辨率:2.0 支持 480p/720p/1080p/4k,`fast` / `mini` 只到 720p;1.0 为 480p/720p/1080p。1.0 不支持 `reference_image` 角色,`1.0 pro fast` 也不支持尾帧,面板会把这两种模式从该型号上收起来。 |
189
189
  | 算力萌 comemoe | `wan2.2-t2v`、`zhimeng-h3-local` | `wan2.2-t2v` 仅文生视频;`zhimeng-h3-local` 支持图生视频。比例只接受 16:9 / 9:16 / 1:1;5 秒片子实测约 9 分钟。 |
190
190
  | xAI Grok | `grok-imagine-video-1.5`、`grok-imagine-video-1.5-lite` | 提交 `POST /videos/generations`(注意不是 `/videos`),轮询 `GET /videos/{id}`,取 `video.url` 与 `video.duration`。 |
191
+ | snapgen.ai | `grok-1.5-lite`、`grok-video`、`grok-lower`、`muse-ai-video`、`vela-ai-video` | 非 OpenAI 兼容:`multipart` 提交 + 反爬守卫头 `x-guard-id`,返回历史 `uuid` 而不是任务 id,`GET /history/{uuid}` 用**数字状态** 1 生成中 / 2 完成 / 3 失败,成片在 `generated_video[0].video_url`(预签名,未鉴权即可下载)。每次提交要一枚一次性 Cloudflare Turnstile token,由本机 CDP Chrome 现场换取。详见下文。 |
191
192
  | 通用视频 | 其他视频模型 id | 按 OpenAI 兼容视频端点尽力适配;未识别的协议族会明确报错,不会静默发出错误请求。 |
192
193
 
193
194
  - **生成模式**:文生视频、图生视频(单张参考图)、首尾帧(首帧+尾帧插值)、参考图(多张风格/主体参考);不同模型支持的模式不同,面板只会给出该模型支持的选项。
@@ -204,6 +205,37 @@ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-X.Y.Z.tgz
204
205
 
205
206
  </details>
206
207
 
208
+ #### snapgen.ai 视频(需要本机 Chrome)
209
+
210
+ 预置渠道里选 **snapgen.ai** 即可带出五个视频模型。这条链路和别的渠道有三处不一样,配置时要注意:
211
+
212
+ **1. 密钥填 refresh_token,不是 access_token。** snapgen 的 access_token 只有十分钟寿命,过期后接口返回的是 `403 TOKEN_EXPIRED` 而不是 401。渠道密钥可以填三样东西之一:
213
+
214
+ - 直接填 `refresh_token`(形如 `"邮箱".xxxx.yyyy`)——最简单;
215
+ - 或者填 JSON:`{"refresh_token":"…","cdp_port":9333}`,其中 `cdp_port` 指定去哪个 CDP 端口换 Turnstile;
216
+ - 或者填一个还没过期的 `access_token`(JWT,`eyJ…` 开头),只在它过期前能用。
217
+
218
+ 宿主每次提交前都会用 refresh_token 换新 token,所以刷新失效时只需更新这一个字段。
219
+
220
+ **2. 提交前要一枚 Turnstile token,只能由真浏览器换来。** snapgen 不接受没有 `turnstile_token` 的提交(`400 TURNSTILE_REQUIRED`),也不接受复用的 token。插件会在提交时连上本机带调试端口的 Chrome,在 snapgen.ai 页面里现场渲染并执行一次 Turnstile 组件,把拿到的 token 塞进这次 `multipart` 请求。所以:
221
+
222
+ - 需要本机有一个开了 `--remote-debugging-port` 的 Chrome(默认 9333),并且有(或能自动打开)一个 snapgen.ai 标签页;无头模式同样可用。
223
+ - 换不到 token 时提交会直接报 `snapgen-turnstile`,不会发一个注定被拒的请求。
224
+ - 这一步与登录状态无关,用的是站点公开的 Turnstile sitekey。
225
+
226
+ **3. 参数与模式按模型收窄。** 面板会按所选模型给出该模型真正接受的比例/分辨率/时长:
227
+
228
+ | 模型 | 模式 | 比例 | 分辨率 | 时长 | 额度 |
229
+ | --- | --- | --- | --- | --- | --- |
230
+ | `grok-1.5-lite` | 文生视频 | 16:9 / 9:16 / 1:1 / 4:3 / 3:4(线上映射成 landscape / portrait / square / 3:2 / 2:3) | 480p / 720p / 1080p | 6 / 10 / 15 秒 | 免费账号每天 5 条;1080p 需要付费套餐 |
231
+ | `grok-video`、`grok-lower` | 文生视频 | 同上 | 480p / 720p / 1080p(`grok-video` 另有 4k) | 6 / 10 / 15 秒 | 免费账号不可用(`main_limit 0/0`) |
232
+ | `muse-ai-video` | 文生 / 图生视频 | landscape / portrait / square | — | 固定 10 秒 | 每天 100 条 |
233
+ | `vela-ai-video` | 文生 / 图生视频 | landscape / portrait / square | — | 固定 5 秒 | 每天 10 条,但服务端长期维护中,实测常返回 `HIGH_TRAFFIC_ERROR` |
234
+
235
+ 超出套餐或额度时返回的是 `snapgen-premium` / `snapgen-quota` / `snapgen-credit`,面板与 Agent 会原样转述上游文案(例如「Daily limit reached (main_limit: 5/5)」)。
236
+
237
+ 代码落点:`src/snapgen-engine.ts`(守卫头、Turnstile、`multipart` 提交、数字状态轮询、token 刷新)与 `src/video-engine.ts` 的 `snapgen` 分支。
238
+
207
239
  #### 代码生成路径(不调生图/生视频模型)
208
240
 
209
241
  画布合成栏里有一个「生成方式」下拉,两个选项:**模型生成**(默认,就是上面那整条链路)和**代码生成**。它**按任务选**,不写进设置、不做全局开关;同一个画布上这一张用模型、下一张用代码都行。
@@ -0,0 +1,57 @@
1
+ # v1.20.0 · 接入 snapgen.ai 视频模型
2
+
3
+ 本版新增 snapgen.ai 视频协议族,把 Grok / Muse / Vela 系列视频模型接进插件;同时把视频时长与画面比例的选项改成由模型目录驱动,并解除“渠道必须至少有一个图片模型”的限制。
4
+
5
+ ## 主要更新
6
+
7
+ - **新增 `snapgen.ai` 渠道预设**,支持 `grok-1.5-lite`、`grok-video`、`grok-lower`、`muse-ai-video`、`vela-ai-video`:
8
+ - 该服务不是 OpenAI 兼容接口,`src/snapgen-engine.ts` 单独实现四条差异:multipart 提交 + 自研反爬守卫头
9
+ `x-guard-id`;返回历史 uuid 而不是任务 id;`GET /history/{uuid}` 用数字状态(1 生成中 / 2 完成 / 3 失败);
10
+ 成片地址在 `generated_video[0].video_url`(预签名,未鉴权即可下载)。`video-engine.ts` 只做编排。
11
+ - 密钥栏填 **refresh_token**:Access Token 只有约 10 分钟有效期,且过期返回的是 HTTP 403 `TOKEN_EXPIRED`
12
+ 而不是 401,所以引擎按 JWT `exp` 提前续期,并在收到带 TOKEN 字样的 403 时强制刷新后重试一次。
13
+ 接受原始 refresh_token、`{"refresh_token":"…","cdp_port":9333}` 形式的 JSON,或仍在有效期内的 access_token。
14
+ - 每次提交都需要一枚一次性 Cloudflare Turnstile token(绑定 site key,无法缓存或本地计算),
15
+ 由本机 CDP Chrome 在真实 snapgen.ai 页面上现场换取:默认端口 9333,无头 Chrome 亦可。
16
+ 换不到时错误码为 `snapgen-turnstile`。
17
+ - **按模型收窄时长与比例词表**:`grok-*` 为 6/10/15 秒,`muse-ai-video` 固定 10 秒,`vela-ai-video` 固定 5 秒;
18
+ 比例在 `grok-*` 上映射为 landscape / portrait / square / 3:2 / 2:3,在 `muse`/`vela` 上只有前三种。
19
+ 视频面板与画布作曲家的时长、比例、分辨率下拉都改为读 `describeVideoModel()` 的目录数据,
20
+ 不再写死 `[5, 10]` 与 `['16:9','9:16','1:1']`。
21
+ - **只有视频模型的渠道可以保存**:以前 `validateChannelDraft` 要求至少一个图片模型标识,只接视频的渠道存不下来;
22
+ 现在图片或视频模型任一非空即可,侧栏的就绪状态与模型计数也一并按两者合计。
23
+ - **预设列表显示并可搜索视频模型**:预设行原来只展示图片模型别名,snapgen 这类纯视频预设会显示为空白;
24
+ 现在搜索与行内说明都包含视频模型别名。
25
+ - **修复浏览器布局守卫的假失败**:`verify-video-layout.mjs` 用 1520px 宽的窗口描述问题,却从未设置视口,
26
+ 无头 Chrome 默认 756×469 会命中样式表自己的 `@media (max-width: 760px)` 断点,把生成行折成一列后
27
+ 报出并不存在的“37% 太窄”。现在用 `Emulation.setDeviceMetricsOverride` 固定视口,守卫测得 97% 通过。
28
+ - **修复对比任务并发断言在负载下抖动**:模拟上游的重叠窗口只有 50ms,整套测试并行跑时会退化成串行,
29
+ 报 `maxGenerationRequests===1`。窗口放宽到 300ms,断言仍是“两条请求在上游重叠”。
30
+
31
+ ## 验证
32
+
33
+ - `tsc --noEmit` 0 错,`pnpm build` 通过。
34
+ - 离线冒烟新增两组断言:守卫字节与线上实测值逐字节对齐(含 `/api` 前缀参与签名的证明),
35
+ 以及空密钥 / 不支持的生成模式在触网前就失败并留下诊断记录。`smoke-video.mjs` 33 项全过。
36
+ - 通过插件本体的 `generateVideo()` 对 api.snapgen.ai 实跑出片:
37
+ 文生视频 `muse-ai-video` 10 秒 4.3 MB、图生视频 10 秒 7.7 MB,`ffprobe` 均为 h264 + aac 的有效 MP4。
38
+
39
+ ## 已知限制
40
+
41
+ - `vela-ai-video` 提交会被接受,但服务端当前稳定返回 `HIGH_TRAFFIC_ERROR`(页面也标为维护中),插件如实透传该错误。
42
+ - `grok-video` 与 `grok-lower` 需要付费套餐,免费账号上游返回 `DAILY_LIMIT_EXCEEDED`(错误码 `snapgen-quota`)。
43
+ - grok 系列是否接受参考图(`files` 字段)尚未实测:免费额度只有每天 5 条,当日额度已用尽。
44
+
45
+ ## 安装
46
+
47
+ 从 DSH 插件市场安装:
48
+
49
+ ```bash
50
+ dsh plugin --profile web add @q253595422/dsh-imagegen-video@1.20.0
51
+ ```
52
+
53
+ 本地安装发布产物:
54
+
55
+ ```bash
56
+ dsh plugin --profile web add ./q253595422-dsh-imagegen-video-1.20.0.tgz
57
+ ```