@remixmate/cli 0.9.19 → 0.9.20

package/README.md

@@ -165,8 +165,8 @@ This project contains 11 AI media generation skills covering the full pipeline f
 │  export-jianying      Assets → Jianying draft ZIP           │
 ├─────────────────────────────────────────────────────────────┤
 │ Atomic Skills                                                │
-│  gen-image         Text/Image-to-image (Seedream / Gemini)  │
-│  gen-video         Text-to-video (Seedance / Veo)           │
+│  gen-image         Text/Image-to-image (Seedream 5.0)       │
+│  gen-video         Text-to-video (Seedance 2.0)             │
 │  gen-voice         Text-to-speech (Minimax TTS)             │
 │  gen-digital-human Talking-head (Jimeng / Feiying)          │
 ├─────────────────────────────────────────────────────────────┤
@@ -203,8 +203,8 @@ This project contains 11 AI media generation skills covering the full pipeline f
 
 | Skill | Type | Description | Runtime / entry |
 |-------|------|-------------|-----------------|
-| gen-image | atomic | Text/Image-to-image (Seedream, Gemini) | http handler |
-| gen-video | atomic | Text-to-video (Seedance, Veo) | http handler |
+| gen-image | atomic | Text/Image-to-image (Seedream 5.0 Lite / Pro) | http handler |
+| gen-video | atomic | Text-to-video (Seedance 2.0, three tiers) | http handler |
 | gen-voice | atomic | Text-to-speech (Minimax TTS) | http handler |
 | gen-digital-human | atomic | Talking-head (Jimeng / Feiying) | http handler |
 | gen-script | orchestration | Topic → Video DSL JSON | python `scripts/gen_script.py` |
@@ -296,8 +296,8 @@ remixmate template-registry --list-templates
 ### Quick start
 
 ```
-@skills/gen-image/SKILL.md Generate an image of a panda, 9:16, using gemini, Chinese-painting style + follow this doc strictly
-@skills/gen-video/SKILL.md Generate a video of a panda running in a bamboo forest, 9:16, 6 seconds, using veo + follow this doc strictly
+@skills/gen-image/SKILL.md Generate an image of a panda, 9:16, using seedream-pro, Chinese-painting style + follow this doc strictly
+@skills/gen-video/SKILL.md Generate a video of a panda running in a bamboo forest, 9:16, 6 seconds, using seedance-mini + follow this doc strictly
 @skills/gen-voice/SKILL.md Generate a voiceover introducing panda habits, around 100 words + follow this doc strictly
 @skills/gen-digital-human/SKILL.md Get the digital human list + follow this doc strictly
 @skills/template-registry/SKILL.md Get the template list + follow this doc strictly

package/README.zh-CN.md

@@ -124,8 +124,8 @@ Python 技能（12 个中的 8 个）需要 `python3 >= 3.10`。`web-screenshot`
 │  export-jianying      素材 → 剪映草稿 ZIP                    │
 ├─────────────────────────────────────────────────────────────┤
 │ 原子层 Skills                                                │
-│  gen-image         文生图 / 图生图（Seedream / Gemini）      │
-│  gen-video         文生视频（Seedance / Veo）                │
+│  gen-image         文生图 / 图生图（Seedream 5.0）           │
+│  gen-video         文生视频（Seedance 2.0）                  │
 │  gen-voice         语音合成（Minimax TTS）                   │
 │  gen-digital-human 数字人口播（即梦 / 飞影）                 │
 ├─────────────────────────────────────────────────────────────┤
@@ -162,8 +162,8 @@ Python 技能（12 个中的 8 个）需要 `python3 >= 3.10`。`web-screenshot`
 
 | 技能 | 类型 | 说明 | 运行方式 / entry |
 |------|------|------|------------------|
-| gen-image | 原子 | 文生图 / 图生图（Seedream、Gemini） | http handler |
-| gen-video | 原子 | 文生视频（Seedance、Veo） | http handler |
+| gen-image | 原子 | 文生图 / 图生图（Seedream 5.0 Lite / Pro） | http handler |
+| gen-video | 原子 | 文生视频（Seedance 2.0 三档） | http handler |
 | gen-voice | 原子 | 语音合成（Minimax TTS） | http handler |
 | gen-digital-human | 原子 | 数字人口播（即梦 / 飞影） | http handler |
 | gen-script | 编排 | 主题 → Video DSL JSON | python `scripts/gen_script.py` |
@@ -232,8 +232,8 @@ remixmate template-registry --list-templates
 ### 快速体验
 
 ```
-@skills/gen-image/SKILL.md 生成一张熊猫的图片，9:16，调用gemini，国画风 + 严格按该文档执行
-@skills/gen-video/SKILL.md 生成一段熊猫在竹林奔跑的视频，9:16，长度6秒，调用veo + 严格按该文档执行
+@skills/gen-image/SKILL.md 生成一张熊猫的图片，9:16，调用 seedream-pro，国画风 + 严格按该文档执行
+@skills/gen-video/SKILL.md 生成一段熊猫在竹林奔跑的视频，9:16，长度6秒，用 seedance-mini + 严格按该文档执行
 @skills/gen-voice/SKILL.md 生成一段语音，介绍熊猫的习性，大概100字左右 + 严格按该文档执行
 @skills/gen-digital-human/SKILL.md 获取数字人列表 + 严格按该文档执行
 @skills/template-registry/SKILL.md 获取模版列表 + 严格按该文档执行

package/dist/handlers/gen-image.d.ts

@@ -9,7 +9,8 @@
  *     through and is validated by the backend).
  *   - --size accepts a WxH string (→ width/height) or an aspect-ratio preset key
  *     (→ aspectRatio; for Seedream models ab-api maps the preset to pixels).
- *   - --resolution maps to the Gemini `size` tier (1K/2K/4K); ignored by others.
+ *   - --resolution is accepted but inert: it only ever fed the Gemini `size` tier,
+ *     and Gemini is not wired up on the gateway, so we no longer send it.
  *   - Reference images: HTTPS URLs and data: URIs pass through; local paths are
  *     read and base64-encoded into a data: URI.
  *   - Async response (generationId + status:'generating'/'pending') is polled

package/dist/handlers/gen-image.js

@@ -9,7 +9,8 @@
  *     through and is validated by the backend).
  *   - --size accepts a WxH string (→ width/height) or an aspect-ratio preset key
  *     (→ aspectRatio; for Seedream models ab-api maps the preset to pixels).
- *   - --resolution maps to the Gemini `size` tier (1K/2K/4K); ignored by others.
+ *   - --resolution is accepted but inert: it only ever fed the Gemini `size` tier,
+ *     and Gemini is not wired up on the gateway, so we no longer send it.
  *   - Reference images: HTTPS URLs and data: URIs pass through; local paths are
  *     read and base64-encoded into a data: URI.
  *   - Async response (generationId + status:'generating'/'pending') is polled
@@ -48,7 +49,6 @@ export async function genImage(input, ctxIn) {
     const model = descriptor?.id ?? requested ?? defaultModel(caps.image)?.id ?? '';
     const size = input.size ?? '1:1';
     const n = toNumber(input.n, 'n') ?? 1;
-    const resolution = input.resolution ?? '1K';
     const seed = toNumber(input.seed, 'seed');
     const imageStrength = toNumber(input.image_strength, 'image_strength');
     const guidanceScale = toNumber(input.guidance_scale, 'guidance_scale');
@@ -76,8 +76,8 @@ export async function genImage(input, ctxIn) {
     if (watermark !== undefined)
         payload.watermark = watermark;
     // --size as WxH → explicit pixels; otherwise treat as an aspect-ratio preset.
-    // ab-api maps an aspect-ratio preset to pixels for Seedream and uses it directly
-    // for Gemini, so the CLI carries no per-model size table.
+    // ab-api maps an aspect-ratio preset to that model's pixel table, so the CLI
+    // carries no per-model size table.
     if (/^\d+x\d+$/i.test(size)) {
         const [w, h] = size.toLowerCase().split('x').map((v) => parseInt(v, 10));
         payload.width = w;
@@ -86,7 +86,6 @@ export async function genImage(input, ctxIn) {
     else {
         payload.aspectRatio = size;
     }
-    payload.size = resolution;
     const ctx = await resolveHttpContext(ctxIn.skillName, {
         apiBaseUrl,
         privateToken: input.priv_token,

package/dist/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "version": "0.9.19",
-  "generatedAt": "2026-09-02T05:46:15.901Z",
+  "version": "0.9.20",
+  "generatedAt": "2026-09-05T03:37:29.567Z",
   "skills": [
     {
       "id": "export-jianying",
@@ -217,11 +217,11 @@
       "tier": "atomic",
       "category": "asset",
       "title": "AI Image Generation",
-      "summary": "AI image generation: produce an image from a text prompt. Supports the Seedream family (including a high-fidelity 'pro' variant) and Gemini, plus image-to-image with reference images.",
+      "summary": "AI image generation: produce an image from a text prompt. Supports the Seedream 5.0 family (Lite and a high-fidelity 'pro' variant), plus image-to-image with reference images.",
       "triggers": [
         "AI image generation, text-to-image, \"draw me ...\", \"generate an image of ...\"",
         "Image-to-image, reference image, style transfer, image variation",
-        "Generate an image with Doubao / Seedream / Gemini",
+        "Generate an image with Doubao / Seedream",
         "Provide a prompt and ask for an image"
       ],
       "entry": {
@@ -244,7 +244,7 @@
           },
           "model": {
             "type": "string",
-            "description": "Model: 'seedream' (default), 'seedream-pro' (high fidelity, precise placement and on-image text; costs more per image), or 'gemini'"
+            "description": "Model: 'seedream' (default, Seedream 5.0 Lite) or 'seedream-pro' (high fidelity, precise placement and on-image text; costs more per image)"
           },
           "size": {
             "type": "string",
@@ -257,7 +257,7 @@
               "2K",
               "4K"
             ],
-            "description": "Output resolution (Gemini only)"
+            "description": "Output resolution tier. Currently inert: the only backend model that read it (Gemini) is not wired up, so this is ignored — use `size` for image dimensions."
           },
           "n": {
             "type": "number",
@@ -268,7 +268,7 @@
             "items": {
               "type": "string"
             },
-            "description": "Reference images for image-to-image: local file path, https URL, or data URI. Pass multiple to blend several references (seedream: max 14, seedream-pro: max 10, gemini: max 4 — over the limit fails before spending credits)."
+            "description": "Reference images for image-to-image: local file path, https URL, or data URI. Pass multiple to blend several references (seedream: max 14, seedream-pro: max 10 — over the limit fails before spending credits)."
           },
           "image_strength": {
             "type": "number",
@@ -309,14 +309,14 @@
           "n",
           "reference",
           "negative_prompt",
-          "resolution",
           "image_strength"
         ],
         "hidden": [
           "json_output",
           "seed",
           "guidance_scale",
-          "watermark"
+          "watermark",
+          "resolution"
         ]
       }
     },
@@ -406,7 +406,7 @@
             "items": {
               "type": "string"
             },
-            "description": "Bottom typewriter text lines for templates that support a caption/typewriter area (e.g. spotlight-card). Each element is one line of text. Supports **emphasis** syntax (rendered with accent color). **Must** pass when the user explicitly provides bullet-point text / bottom copy for the video."
+            "description": "Bottom typewriter text lines for templates that support a caption/typewriter area (e.g. spotlight-card). Each element is one line of text, max 10 lines. Supports **emphasis** syntax (rendered with accent color). **Must** pass when the user explicitly provides bullet-point text / bottom copy. **Also must pass — written by you — when the user did NOT provide any copy but the template is typewriter-driven** (capabilities.durationStrategy=fit-caption, e.g. spotlight-card): such templates have no narration, so these lines are both the video's content and the thing that decides its duration. Draft them from the material you researched (repo README, page screenshots, the topic). Leaving this empty for a fit-caption template is rejected: nothing auto-generates caption text, and an empty caption renders a titled carousel with no words at all."
           },
           "stub_image_url": {
             "type": "string",
@@ -455,10 +455,10 @@
       "tier": "atomic",
       "category": "asset",
       "title": "AI Video Generation",
-      "summary": "AI video generation: produce a short video clip from a text prompt. Supports Seedance and Veo models, plus first/last frame and reference images.",
+      "summary": "AI video generation: produce a short video clip from a text prompt. Three Seedance 2.0 tiers (mini / fast / standard), plus first/last frame and reference images.",
       "triggers": [
         "Text-to-video, AI-generated clip, \"make a short video of ...\"",
-        "Generate video with Doubao / Seedance / Veo / Google",
+        "Generate video with Doubao / Seedance",
         "Image-to-video, first-frame / last-frame, reference-image-to-video"
       ],
       "entry": {
@@ -481,7 +481,7 @@
           },
           "model": {
             "type": "string",
-            "description": "Model: 'seedance' (default; 4-12s, adaptive/21:9 ratios, fixed camera), 'veo' (4/6/8s, native audio, up to 4k, reference images), or 'veo-fast' (faster Veo variant for iteration)"
+            "description": "Model: 'seedance-mini' (default; cheapest, 480p/720p), 'seedance-fast' (480p/720p), or 'seedance' (Seedance 2.0, adds 1080p). All are 4-15s and share the same features"
           },
           "duration": {
             "type": "number",
@@ -508,7 +508,7 @@
             "items": {
               "type": "string"
             },
-            "description": "Reference images: local file path, https URL, or data URI. Veo only, max 3 — Seedance rejects them, use first_frame / last_frame instead."
+            "description": "Reference images: local file path, https URL, or data URI. Up to 9; combinable with first_frame / last_frame."
           },
           "generate_audio": {
             "type": "boolean",
@@ -520,7 +520,7 @@
           },
           "negative_prompt": {
             "type": "string",
-            "description": "Content to steer away from (Veo)"
+            "description": "Content to steer away from. Veo only — Seedance ignores it (kept for when a Veo channel is available again)"
           },
           "seed": {
             "type": "number",
@@ -556,12 +556,12 @@
           "last_frame",
           "reference",
           "generate_audio",
-          "camera_fixed",
-          "negative_prompt"
+          "camera_fixed"
         ],
         "hidden": [
           "json_output",
           "seed",
+          "negative_prompt",
           "person_generation"
         ]
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remixmate/cli",
-  "version": "0.9.19",
+  "version": "0.9.20",
   "description": "AI media generation skills for Claude Code / Codex — 12 skills covering image, video, voice, digital human, web screenshot, web recording, script, template registry, rendering, Jianying export, and video deconstruction.",
   "type": "module",
   "main": "dist/index.js",

package/skills/gen-image/SKILL.md

@@ -1,25 +1,25 @@
 ---
 name: gen-image
 description: |
-  AI image generation skill: produce an image from a text prompt, or do image-to-image with reference images. Backed by ab-api's `/model/genImg` (Seedream and Gemini families).
+  AI image generation skill: produce an image from a text prompt, or do image-to-image with reference images. Backed by ab-api's `/model/genImg` (the Seedream 5.0 family).
 
   Use this skill immediately whenever the user asks for any of:
   - AI image generation, text-to-image, "draw me ...", "generate an image of ..."
   - Image-to-image, reference image, style transfer, image variation
-  - Generate an image with Doubao / Seedream / Gemini
+  - Generate an image with Doubao / Seedream
   - Provide a prompt and ask for an image
 
   Even without an explicit "use AI", any request that turns a description into an image should route here.
 triggers:
   - AI image generation, text-to-image, "draw me ...", "generate an image of ..."
   - Image-to-image, reference image, style transfer, image variation
-  - Generate an image with Doubao / Seedream / Gemini
+  - Generate an image with Doubao / Seedream
   - Provide a prompt and ask for an image
 ---
 
 # AI Image Generation Skill
 
-Wraps ab-api's `POST /model/genImg` (the same endpoint the web studio uses), authenticated with the **Tianyan privateToken**, routed through LiteLLM to **Seedream** or **Gemini**.
+Wraps ab-api's `POST /model/genImg` (the same endpoint the web studio uses), authenticated with the **Tianyan privateToken**, routed through LiteLLM to the **Seedream 5.0** family.
 
 ## Models and sizes
 
@@ -31,7 +31,6 @@ the names below are the stable aliases to use.
 |-----------|------------|------------------|
 | `seedream` | Default. General-purpose, highest output resolution. | up to 14 |
 | `seedream-pro` | High-fidelity variant: better placement/element control, more faithful text rendering. Costs more per image. | up to 10 |
-| `gemini` | Gemini 3 Pro. | up to 4 |
 
 - **Seedream**: `--size` is an aspect ratio (e.g. `1:1`, `9:16`) or `WxH`. The backend maps the
   ratio to that model's own pixel preset and rescales out-of-range sizes, so prefer a ratio
@@ -39,8 +38,8 @@ the names below are the stable aliases to use.
 - **`seedream-pro`** additionally supports `3:2` / `2:3` / `21:9`, and caps output at ~2K
   (about 4.6 MP). Asking it for 4K pixels gets scaled down, not rejected — use `seedream`
   when you need a genuinely larger image.
-- **Gemini**: `--size` is a backend-allowed aspect ratio (e.g. `1:1`, `16:9`); add
-  `--resolution`: `1K` / `2K` / `4K` (default `1K`). `--resolution` is ignored by Seedream.
+- **`--resolution`** is inert today: it only ever applied to Gemini, which is not wired up on
+  the gateway. Control image dimensions with `--size`.
 
 ## Auth & environment
 
@@ -71,14 +70,6 @@ remixmate gen-image \
   --size "9:16"
 ```
 
-```bash
-remixmate gen-image \
-  --prompt "<image description>" \
-  --model gemini \
-  --size "16:9" \
-  --resolution "2K"
-```
-
 ```bash
 # High-fidelity: precise placement, legible on-image text
 remixmate gen-image \
@@ -95,7 +86,6 @@ Reference images accept local file paths, HTTPS URLs, or data URIs. Pass `--refe
 - **`seedream-pro`**: up to **10** reference images. Best choice when the edit has to land in a
   specific spot — describe the target region in the prompt (e.g. "in the marked area at the
   bottom left") and it holds position far better than `seedream`.
-- **`gemini`**: up to **4** reference images.
 
 Over-the-limit runs fail fast in the CLI, before spending credits.
 
@@ -129,13 +119,12 @@ remixmate gen-image \
 | Flag | Description | Default |
 |------|-------------|---------|
 | `-p` / `--prompt` | Description (required) | — |
-| `-m` / `--model` | `seedream` / `seedream-pro` / `gemini` | see `MM_IMAGE_MODEL` |
-| `-s` / `--size` | Seedream: ratio or WxH; Gemini: ratio | `1:1` |
-| `--resolution` | Gemini only: `1K` / `2K` / `4K` | `1K` |
+| `-m` / `--model` | `seedream` / `seedream-pro` | see `MM_IMAGE_MODEL` |
+| `-s` / `--size` | Aspect ratio or WxH | `1:1` |
 | `-n` | Number of images, 1–4 | `1` |
 | `-g` / `--guidance-scale` | Guidance scale (when supported) | backend default |
 | `--reference` | Reference image (repeatable; local path / URL / data URI) | none |
-| `--image-strength` | Reference strength 0–1 (Seedream only) | backend default |
+| `--image-strength` | Reference strength 0–1 | backend default |
 | `--negative-prompt` | Things to avoid | none |
 | `--seed` | Random seed (reproducibility) | none |
 | `--watermark` | Add a watermark (no `--no-watermark` opt-out) | backend default |

package/skills/gen-image/skill.json

@@ -4,7 +4,7 @@
   "tier": "atomic",
   "category": "asset",
   "title": "AI Image Generation",
-  "description": "AI image generation: produce an image from a text prompt. Supports the Seedream family (including a high-fidelity 'pro' variant) and Gemini, plus image-to-image with reference images.",
+  "description": "AI image generation: produce an image from a text prompt. Supports the Seedream 5.0 family (Lite and a high-fidelity 'pro' variant), plus image-to-image with reference images.",
   "auth": "required",
   "joinsTake": true,
   "envVars": [
@@ -26,7 +26,7 @@
       },
       "model": {
         "type": "string",
-        "description": "Model: 'seedream' (default), 'seedream-pro' (high fidelity, precise placement and on-image text; costs more per image), or 'gemini'"
+        "description": "Model: 'seedream' (default, Seedream 5.0 Lite) or 'seedream-pro' (high fidelity, precise placement and on-image text; costs more per image)"
       },
       "size": {
         "type": "string",
@@ -39,7 +39,7 @@
           "2K",
           "4K"
         ],
-        "description": "Output resolution (Gemini only)"
+        "description": "Output resolution tier. Currently inert: the only backend model that read it (Gemini) is not wired up, so this is ignored — use `size` for image dimensions."
       },
       "n": {
         "type": "number",
@@ -50,7 +50,7 @@
         "items": {
           "type": "string"
         },
-        "description": "Reference images for image-to-image: local file path, https URL, or data URI. Pass multiple to blend several references (seedream: max 14, seedream-pro: max 10, gemini: max 4 — over the limit fails before spending credits)."
+        "description": "Reference images for image-to-image: local file path, https URL, or data URI. Pass multiple to blend several references (seedream: max 14, seedream-pro: max 10 — over the limit fails before spending credits)."
       },
       "image_strength": {
         "type": "number",
@@ -91,14 +91,14 @@
       "n",
       "reference",
       "negative_prompt",
-      "resolution",
       "image_strength"
     ],
     "hidden": [
       "json_output",
       "seed",
       "guidance_scale",
-      "watermark"
+      "watermark",
+      "resolution"
     ]
   }
 }

package/skills/gen-image/version.json

@@ -2,6 +2,6 @@
   "skillName": "gen-image",
   "repoName": "agent-skill-media-maker",
   "skillId": "337",
-  "version": "V9",
-  "skillDescription": "AI image generation skill: produce an image from a text prompt, or do image-to-image with reference images. Backed by ab-api's `/model/genImg` (Seedream and Gemini families).\n\nUse this skill immediately whenever the user asks for any of:\n- AI image generation, text-to-image, \"draw me ...\", \"generate an image of ...\"\n- Image-to-image, reference image, style transfer, image variation\n- Generate an image with Doubao / Seedream / Gemini\n- Provide a prompt and ask for an image\n\nEven without an explicit \"use AI\", any request that turns a description into an image should route here."
+  "version": "V10",
+  "skillDescription": "AI image generation skill: produce an image from a text prompt, or do image-to-image with reference images. Backed by ab-api's `/model/genImg` (the Seedream 5.0 family).\n\nUse this skill immediately whenever the user asks for any of:\n- AI image generation, text-to-image, \"draw me ...\", \"generate an image of ...\"\n- Image-to-image, reference image, style transfer, image variation\n- Generate an image with Doubao / Seedream\n- Provide a prompt and ask for an image\n\nEven without an explicit \"use AI\", any request that turns a description into an image should route here."
 }

package/skills/gen-script/SKILL.md

@@ -106,6 +106,18 @@ This skill does not hit any external API; no token required. The script only doe
 Show **every scene in full** — do not collapse them with phrases like "scenes 2–6 same as above".
 The user is reviewing the narration word by word; a summary they cannot proofread defeats the gate.
 
+> ⚠️ **Read every value back from the returned DSL, never from what you meant to pass.**
+> The summary exists so the user can catch a wrong tool call; a summary written from intent hides
+> exactly the bug it should surface.
+> - Durations ← `scenes[].duration`, **not** your `--duration` argument (`fit-caption` / `fit-narration`
+>   templates recompute it and ignore the target you passed).
+> - On-screen text ← `textLayers[]`, `customPayload.caption.lines`, `customPayload.carousel.items` —
+>   quoted verbatim, with the counts you actually see.
+> - If something you intended to set is missing or empty in the returned DSL, that is a failed call:
+>   say so and re-run `gen_script.py` with the right flags. Listing caption lines that are not in
+>   `customPayload.caption.lines` means the user confirms a script that does not exist and pays to
+>   render something else.
+
 ### Summary content
 
 The agent should show the following in clear Markdown:
@@ -156,9 +168,12 @@ For these templates the picture comes from `customPayload.carousel.items`, which
 When the user selects a `carousel-caption` template (or any template whose `assetRequirements` is image/video-only and whose `payloadStyle` is `carousel-caption`):
 
 1. **Extract every media URL the user provided** (image or video links in the prompt) and pass each one as a separate `--carousel-items <url>` flag — preserve the user's order, and pass the URLs **verbatim** (do not rewrite host/path/query).
-2. If the user wants on-screen text, pass each caption line as `--caption-lines '<text>'`. For purely visual templates like `adaptive-image-video` (no text, `needsNarration: false`), captions are optional.
+2. Pass each on-screen caption line as `--caption-lines '<text>'`. Whether this is optional depends on the template's `capabilities.durationStrategy`, **not** on `needsNarration` (every `carousel-caption` template has `needsNarration: false`):
+   - `durationStrategy: fit-caption` (e.g. `spotlight-card`) → **caption lines are mandatory.** The template has no narration and the typewriter copy is both the content and the clock: it is what the video says *and* what decides how long it runs. **If the user did not supply the copy, write it yourself** from the material you researched (repo README, page screenshots, the topic) and pass it. `gen_script.py` hard-fails on an empty caption for these templates.
+   - `durationStrategy: fit-images` (e.g. `adaptive-image-video` / `image-to-video`) → purely visual, captions genuinely optional; duration comes from the image count.
 3. **Never call gen_script for a `carousel-caption` template without `--carousel-items`.** If the user picked such a template but provided no media, ask them for the image/video URLs first — do not generate an empty carousel.
 4. Do **not** route these user-provided images through `gen-image`; they are existing assets and go straight into the carousel.
+5. Nothing downstream fills these in for you. `gen_script.py` routes on `capabilities.payloadStyle` alone — omitting the flags does **not** fall back to a generic path that generates images or writes copy; it assembles an empty carousel / empty caption. There is no auto-generation of caption text anywhere in the pipeline.
 
 ### Command example
 
@@ -266,7 +281,9 @@ python3 <SkillDir>/scripts/gen_script.py \
 |------|-------------|---------|
 | `--topic` | Video topic (required unless `--validate`). | — |
 | `--platform` | Target platform: `douyin` / `xiaohongshu` / `bilibili` / `wechat` / `youtube` / `generic`. | `generic` |
-| `--duration` | Target duration (seconds). | `30` |
+| `--headline` | On-screen main title (4–12 chars / ~3 words). Written to `meta.headline` + `textLayers[role=headline]`. **Pass it whenever the user gave a title** — otherwise headline falls back to the long-form topic and overflows the top text layer. | falls back to `--topic` |
+| `--subheadline` | On-screen subtitle / project name / slogan. Written to `meta.subheadline` + `textLayers[role=subheadline]`. Not the same thing as CC subtitles (`global.subtitle`). | `""` |
+| `--duration` | Target duration (seconds). Templates whose `durationStrategy` is `fit-caption` / `fit-narration` recompute the real duration and ignore this value. | `30` |
 | `--style` | Style tag. | — |
 | `--ratio` | Aspect ratio. | `16:9` |
 | `--scenes` | Scene count. | auto-planned |
@@ -279,7 +296,7 @@ python3 <SkillDir>/scripts/gen_script.py \
 | `--stub-image-url` | Test mode: every image AssetRef is written as existing + generated + this URL, no prompt (env: `STUB_IMAGE_URL`). | — |
 | `--stub-video-url` | Test mode: every video AssetRef is written as existing + generated + this URL, no prompt (env: `STUB_VIDEO_URL`). | — |
 | `--carousel-items` | Repeatable. Media URL placed directly into `customPayload.carousel.items` for `carousel-caption` templates (e.g. `adaptive-image-video`, `spotlight-card`). Bypasses gen-image. **Required** for `carousel-caption` templates when the user supplies images. | — |
-| `--caption-lines` | Repeatable. On-screen typewriter caption line for `carousel-caption` templates → `customPayload.caption.lines`. Supports `**emphasis**`. Optional for purely visual templates. | — |
+| `--caption-lines` | Repeatable. On-screen typewriter caption line for `carousel-caption` templates → `customPayload.caption.lines` (max 10 lines). Supports `**emphasis**`. **Required** for `durationStrategy: fit-caption` templates (`spotlight-card`) — write the lines yourself if the user did not supply them. Optional only for `fit-images` templates. | — |
 
 ## DSL generation principles
 
@@ -295,7 +312,7 @@ Apply the following principles when producing the DSL:
    instead of one continuous paragraph.
 5. **Moderate scene count**: 30-second videos work well with 4–6 scenes, 60-second videos with 6–10.
 6. **Leave room for templates**: pick generic layouts; do not assume a specific template implementation.
-7. **Image model allowlist**: every `type: image` + `source: gen-image` `AssetRef`'s `payload.model` **must** be one of the values in the table below. **Never** use display names, short forms, or made-up ids (e.g. `seedream`, `gemini-flash`, etc.).
+7. **Image model allowlist**: every `type: image` + `source: gen-image` `AssetRef`'s `payload.model` **must** be one of the values in the table below. **Never** use display names, short forms, or made-up ids (e.g. `seedream`, `seedream-5`, etc.).
 
 ### Allowlist `model` values aligned with gen-image
 
@@ -307,12 +324,11 @@ prefix and version — not a short alias:
 |-----------------|--------------|----------|-------|
 | `doubao/doubao-seedream-5-0-260128` | Seedream 5.0 Lite | Volcano | Default. Highest output resolution, up to 14 reference images. |
 | `doubao/doubao-seedream-5-0-pro-260628` | Seedream 5.0 Pro | Volcano | High fidelity: precise element placement, faithful on-image text. Up to 10 reference images, caps out around 2K. Costs noticeably more per image. |
-| `gemini-3-pro` | Gemini 3 Pro | Google | Up to 4 reference images. |
 
 **Agent behavior (avoid accidentally rewriting `model`)**:
 
 - `gen_script.py` already writes a valid `payload.model` (`doubao/doubao-seedream-5-0-260128` unless `DEFAULT_IMAGE_MODEL` overrides it). When the user only asks to refine narration, change `payload.prompt`, add or remove scenes, etc. and does **not** ask to change the image model, the agent **must keep** each image asset's original `payload.model` — do not replace it under the guise of "polishing the script".
-- **Only when the user explicitly asks to change the image model** (e.g. switches to the Pro variant or to Gemini), update the corresponding image `AssetRef`'s `payload.model` to the matching row id from the table. Writing a display name or an alias into JSON is wrong.
+- **Only when the user explicitly asks to change the image model** (e.g. switches to the Pro variant), update the corresponding image `AssetRef`'s `payload.model` to the matching row id from the table. Writing a display name or an alias into JSON is wrong.
 - When creating a new image `AssetRef`, pick one of the values above for `payload.model`; default to `doubao/doubao-seedream-5-0-260128` to match the script, or to whichever value the user specified.
 - If a run fails with an unknown-model error, the catalog has moved on from this table — check `/model/capabilities` rather than guessing a version string.
 
@@ -321,6 +337,9 @@ prefix and version — not a short alias:
 - **Schema validation failed**: check the DSL JSON shape and required fields against the schema.
 - **Scene duration mismatch**: adjust the narration length or the scene duration.
 - **Invalid platform**: look at the supported-platform list.
+- **`carousel-caption template ... needs visual or text content`**: you passed neither `--carousel-items` nor `--caption-lines`. Pass the user's media URLs (and caption lines where the template requires them).
+- **`template ... is typewriter-driven ... but --caption-lines is empty`**: a `fit-caption` template (e.g. `spotlight-card`) got no caption. Write the copy yourself if the user did not supply it, then pass one `--caption-lines` per line.
+- **`duration Ns is below/above template ... supportedDurations`**: the assembled DSL falls outside the range the template declares it was designed for. Below the minimum usually means the content is too thin (add caption lines / narration / scenes); above the maximum means trimming content or lowering `--duration`. This is enforced at generation time on purpose — a degenerate video still costs full render credits.
 
 ## scripts/ contents
 

package/skills/gen-script/scripts/gen_script.py

@@ -475,6 +475,51 @@ def _resolve_contract(template_config: dict | None) -> dict:
     }
 
 
+def _enforce_supported_duration(
+    dsl: dict, template_config: dict | None, template_id: str | None
+) -> None:
+    """校验成片总时长落在模板自己声明的 ``supportedDurations`` 区间内。
+
+    这条约束此前只在 template-library 的 CI（``check-dsl-examples.mjs``）对仓库里的
+    示例 DSL 生效，运行时链路（gen_script → prepare_video_assets → render_video）没有
+    任何一环校验它。于是 spotlight-card（``min: 10``）可以静默产出 5s 成片——模板自己
+    声明"我不是为 5s 设计的"，却没人拦。这里在 DSL 出厂前补上同一道栅栏。
+
+    越界即报错退出，而不是静默出片：时长不足通常意味着内容（打字机文案 / 旁白 / 场景）
+    根本没填够，继续往下走只会烧掉渲染积分换一条废片。
+    """
+    sd = (template_config or {}).get("supportedDurations")
+    if not isinstance(sd, dict):
+        return
+
+    total = sum(s.get("duration", 0) for s in dsl.get("scenes", []))
+    lo = sd.get("min")
+    hi = sd.get("max")
+
+    if isinstance(lo, (int, float)) and total < lo:
+        print(
+            f"❌ duration {total}s is below template '{template_id}' declared minimum {lo}s "
+            f"(supportedDurations: [{lo}, {hi}]).\n"
+            "   The template declares it is not designed for clips this short; rendering "
+            "anyway burns credits on a degenerate video.\n"
+            "   Fix: add content until the estimated duration reaches the minimum — more "
+            "--caption-lines for typewriter-driven templates, longer narration / more scenes "
+            "for narration-driven ones.",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+    if isinstance(hi, (int, float)) and total > hi:
+        print(
+            f"❌ duration {total}s exceeds template '{template_id}' declared maximum {hi}s "
+            f"(supportedDurations: [{lo}, {hi}]).\n"
+            "   Fix: shorten the content (fewer --caption-lines / scenes) or lower --duration, "
+            "or pick a template that supports longer videos.",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+
 def _plan_contract_scenes(
     contract: dict, topic: str, duration: int, scene_count: int | None, language: str
 ) -> list:
@@ -586,6 +631,8 @@ def _build_carousel_caption_dsl(
     resolution: str,
     output_language: str,
     resolved_voice_id: str,
+    font_id: str | None,
+    font_name: str | None,
     narration_enabled: bool,
     payload_defaults: dict,
     duration_strategy: str | None,
@@ -732,6 +779,7 @@ def _build_carousel_caption_dsl(
             # 并省略 global.narration，避免下游误判存在旁白。
             "subtitle": {"enabled": narration_enabled, "style": "bottom"},
             **({"narration": {"voiceId": resolved_voice_id, "speed": 1.0}} if narration_enabled else {}),
+            **({"font": {"fontId": font_id, **({"fontName": font_name} if font_name else {})}} if font_id else {}),
             "bgm": {"enabled": True, "volume": 0.12},
         },
         "assets": assets,
@@ -779,6 +827,8 @@ def build_dsl(
         ratio: str,
         resolution: str,
         voice_id: str,
+        font_id: str | None,
+        font_name: str | None,
         scene_count: int | None,
         allow_digital_human: bool,
         allow_ai_video: bool,
@@ -861,7 +911,32 @@ def build_dsl(
                 file=sys.stderr,
             )
             sys.exit(1)
-        return _build_carousel_caption_dsl(
+        # 兜底校验 ②：durationStrategy=fit-caption 的模板（spotlight-card 类）由打字机
+        # 文案驱动节奏 —— caption 就是内容本体，不是可选装饰。caption_lines 为空时上面的
+        # "两者皆空" 检查放行，产出的却是「顶部标题 + 轮播、底部一个字都没有」的退化片：
+        # 估时掉到轮播地板值（2 张图 ≈ 5s），而调用方往往还在确认摘要里描述了一段
+        # 根本没进 DSL 的文案，用户在确认环节也看不出来。所以这里必须硬失败。
+        # 注意：只卡 fit-caption。carousel-caption 里 durationStrategy=fit-images 的
+        # 纯视觉模板（image-to-video 等）本来就允许无文案，不受影响。
+        if contract["duration_strategy"] == "fit-caption" and not (caption_lines or []):
+            print(
+                "❌ template "
+                f"'{template_id}' is typewriter-driven (capabilities.durationStrategy="
+                "fit-caption), but --caption-lines is empty.\n"
+                "   For this template the bottom typewriter copy IS the content: it carries "
+                "the message and it decides the video length. With no lines the render "
+                "collapses to the carousel floor (~5s for 2 images) and shows no text at all.\n"
+                "   Fix: pass one --caption-lines '<text>' per line. If the user did not "
+                "supply the copy, WRITE IT YOURSELF from the material you researched "
+                "(repo README, page screenshots, the user's topic) and pass it — do not leave "
+                "it empty, and do not describe lines you never passed.\n"
+                "     gen_script.py --topic <topic> --template-id "
+                f"{template_id} --carousel-items <url> "
+                "--caption-lines '<line 1>' --caption-lines '<line 2>' ...",
+                file=sys.stderr,
+            )
+            sys.exit(1)
+        carousel_dsl = _build_carousel_caption_dsl(
             template_id=template_id,
             topic=topic,
             headline=effective_headline,
@@ -875,10 +950,14 @@ def build_dsl(
             resolution=resolution,
             output_language=output_language,
             resolved_voice_id=resolved_voice_id,
+            font_id=font_id,
+            font_name=font_name,
             narration_enabled=needs_narration,
             payload_defaults=contract["payload_defaults"],
             duration_strategy=contract["duration_strategy"],
         )
+        _enforce_supported_duration(carousel_dsl, template_config, template_id)
+        return carousel_dsl
 
     # ── 其余模板：统一场景规划（arc 叙事弧 / single / fixed）+ 统一装配循环 ──────
     scene_plans = _plan_contract_scenes(contract, topic, duration, scene_count, output_language)
@@ -940,14 +1019,16 @@ def build_dsl(
                 })
             else:
                 # 视频素材：复用 image prompt 生成器作为兜底，再追加 "视频/动态" 关键词
-                # 模型 / 时长 / 比例都遵循 gen-video 校验规则（Seedance 4-12s、Veo 4/6/8s）
+                # 模型 / 时长 / 比例都遵循 gen-video 校验规则（Seedance 2.0：4-15s）
                 image_result = generate_image_prompt(plan["purpose"], topic, style, narration_text=narration_text)
                 video_prompt = image_result["prompt"]
-                # 视频时长上限按 gen-video Seedance 模型的 12s 截断，下限 4s
-                video_duration = max(4, min(int(plan["duration"]), 12))
+                # 视频时长按 gen-video 的 4-15s 区间截断
+                video_duration = max(4, min(int(plan["duration"]), 15))
                 vid_payload = {
                     "prompt": video_prompt,
-                    "model": os.environ.get("DEFAULT_VIDEO_MODEL", "doubao-seedance-1-5-pro-251215"),
+                    # 写别名而不是带日期的模型 ID：真源是 ab-api 的能力目录，
+                    # 版本号换代时这里不该跟着改（seedance → 当前的 Seedance 2.0）
+                    "model": os.environ.get("DEFAULT_VIDEO_MODEL", "seedance"),
                     "ratio": ratio,
                     "duration": video_duration,
                 }
@@ -1092,6 +1173,7 @@ def build_dsl(
             # global.narration，避免下游误判存在旁白。
             "subtitle": {"enabled": needs_narration, "style": "bottom"},
             **({"narration": {"voiceId": resolved_voice_id, "speed": 1.0}} if needs_narration else {}),
+            **({"font": {"fontId": font_id, **({"fontName": font_name} if font_name else {})}} if font_id else {}),
             "bgm": {"enabled": True, "volume": 0.12},
         },
         "assets": assets,
@@ -1102,6 +1184,8 @@ def build_dsl(
     if template_id:
         dsl["meta"]["templateId"] = template_id
 
+    _enforce_supported_duration(dsl, template_config, template_id)
+
     return dsl
 
 
@@ -1128,6 +1212,18 @@ Examples:
     parser.add_argument("--resolution", default="1080p", help="Resolution (default: 1080p)")
     parser.add_argument("--scenes", type=int, default=None, help="Scene count (default: auto-planned)")
     parser.add_argument("--voice-id", default=None, help="Narration voice id. When omitted, the resolver picks template.defaultVoiceId, then the language-keyed fallback (zh→Chinese (Mandarin)_Male_Announcer, en→TBD English voice). gen_voice --list-voices --local prints the language-tagged catalog.")
+    parser.add_argument(
+        "--font-id",
+        default=None,
+        help=(
+            "Font family key from the font library (font.uniq_id, e.g. zzgf-xi-mai). "
+            "Omit to follow the template's own font pairing. "
+            "Pass the opaque key, NOT a CSS family name: the family name is a rendering "
+            "detail resolved by ab-render; a mistyped family name silently falls back to "
+            "the default font with no error."
+        ),
+    )
+    parser.add_argument("--font-name", default=None, help="Human-readable font name. Logged and stored for display only; never used for rendering.")
     parser.add_argument("--allow-digital-human", action="store_true", help="Allow digital-human assets")
     parser.add_argument("--allow-ai-video", action="store_true", help="Allow AI-generated video assets")
     parser.add_argument("--template-id", default=None, help="Template id. The template owns outputLanguage and may declare a defaultVoiceId.")
@@ -1276,6 +1372,8 @@ Examples:
         ratio=args.ratio,
         resolution=args.resolution,
         voice_id=args.voice_id,
+        font_id=args.font_id,
+        font_name=args.font_name,
         scene_count=args.scenes,
         allow_digital_human=args.allow_digital_human,
         allow_ai_video=args.allow_ai_video,

package/skills/gen-script/skill.json

@@ -76,7 +76,7 @@
         "items": {
           "type": "string"
         },
-        "description": "Bottom typewriter text lines for templates that support a caption/typewriter area (e.g. spotlight-card). Each element is one line of text. Supports **emphasis** syntax (rendered with accent color). **Must** pass when the user explicitly provides bullet-point text / bottom copy for the video."
+        "description": "Bottom typewriter text lines for templates that support a caption/typewriter area (e.g. spotlight-card). Each element is one line of text, max 10 lines. Supports **emphasis** syntax (rendered with accent color). **Must** pass when the user explicitly provides bullet-point text / bottom copy. **Also must pass — written by you — when the user did NOT provide any copy but the template is typewriter-driven** (capabilities.durationStrategy=fit-caption, e.g. spotlight-card): such templates have no narration, so these lines are both the video's content and the thing that decides its duration. Draft them from the material you researched (repo README, page screenshots, the topic). Leaving this empty for a fit-caption template is rejected: nothing auto-generates caption text, and an empty caption renders a titled carousel with no words at all."
       },
       "stub_image_url": {
         "type": "string",

package/skills/gen-video/SKILL.md

@@ -1,23 +1,23 @@
 ---
 name: gen-video
 description: |
-  AI video generation skill: produce a short clip from a text prompt. Backed by ab-api's `/model/genVideo` (Seedance and Veo families).
+  AI video generation skill: produce a short clip from a text prompt. Backed by ab-api's `/model/genVideo` (Seedance 2.0 family).
 
   Use this skill immediately whenever the user asks for any of:
   - Text-to-video, AI-generated clip, "make a short video of ..."
-  - Generate video with Doubao / Seedance / Veo / Google
+  - Generate video with Doubao / Seedance
   - Image-to-video, first-frame / last-frame, reference-image-to-video
 
   Even without an explicit "use AI", any request that turns a description into a moving clip should route here.
 triggers:
   - Text-to-video, AI-generated clip, "make a short video of ..."
-  - Generate video with Doubao / Seedance / Veo / Google
+  - Generate video with Doubao / Seedance
   - Image-to-video, first-frame / last-frame, reference-image-to-video
 ---
 
 # AI Video Generation Skill
 
-Wraps ab-api's `POST /model/genVideo` (the same endpoint the web "Lingchuang AI Video" tool uses), authenticated with the **Tianyan privateToken**, routed through LiteLLM to **Seedance** or **Veo**. Generation is async — the handler submits the task and polls `/model/getVideoStatus` until completion.
+Wraps ab-api's `POST /model/genVideo` (the same endpoint the web "Lingchuang AI Video" tool uses), authenticated with the **Tianyan privateToken**, routed through LiteLLM to **Seedance 2.0**. Generation is async — the handler submits the task and polls `/model/getVideoStatus` until completion.
 
 > This skill was migrated from a Python script to an remixmate CLI HTTP handler (`entry.type: http`). The agent invocation is unchanged (same tool name `gen_video`, same params as in `skill.json`); local repro goes through `remixmate gen-video ...`.
 
@@ -27,29 +27,34 @@ The authoritative roster — ids, aliases and per-model limits — lives in the
 (`/model/capabilities`), which the CLI fetches at runtime. The table below mirrors it; when the
 two disagree, the catalog wins.
 
-| LiteLLM `model` | Display name | Provider | Duration | Notes |
-|-----------------|--------------|----------|----------|-------|
-| `doubao-seedance-1-5-pro-251215` | Seedance 1.5 Pro | Volcano | 4–12s | Audio support, first/last frame, fixed camera, adaptive ratio |
-| `veo-3.1-generate-001` | Veo 3.1 | Google | 4 / 6 / 8s | Native audio, first/last frame, reference images, negative prompt, up to 4K |
-| `veo-3.1-fast-generate-001` | Veo 3.1 Fast | Google | 4 / 6 / 8s | Faster Veo 3.1 variant for quick iteration |
+All three are Seedance 2.0; they differ only in price tier and top resolution.
+
+| LiteLLM `model` | Display name | Provider | Resolution | Notes |
+|-----------------|--------------|----------|------------|-------|
+| `doubao-seedance-2-0-mini-260615` | Seedance-2.0-mini | Volcano | `480p` `720p` | Default. Cheapest tier (~half the standard rate) |
+| `doubao-seedance-2-0-fast-260128` | Seedance-2.0-fast | Volcano | `480p` `720p` | Mid tier |
+| `doubao-seedance-2-0-260128` | Seedance-2.0 | Volcano | `480p` `720p` `1080p` | Highest quality; the only tier with 1080p |
 
 **Model shortcuts** (`--model` / `-m` accepts these directly):
-- `seedance` / `seedance-1.5` / `seedance-1.5-pro` → Seedance 1.5 Pro
-- `veo` / `veo-3.1` / `veo-3.1-generate` → Veo 3.1
-- `veo-fast` / `veo-3.1-fast` / `veo-3.1-fast-generate` → Veo 3.1 Fast
-
-### Per-model parameter ranges
-
-| | Seedance 1.5 Pro | Veo 3.1 / Veo 3.1 Fast |
-|--|--|--|
-| **Aspect ratio** | `adaptive` `16:9` `4:3` `1:1` `3:4` `9:16` `21:9` | `16:9` `9:16` |
-| **Resolution** | `480p` `720p` `1080p` | `720p` `1080p` `4k` |
-| **Duration** | 4–12 seconds (continuous integers) | 4 / 6 / 8 seconds |
-| **First / last frame** | yes | yes |
-| **Reference images** | not supported (use first/last frame) | yes, up to 3 |
-| **Generated audio** | yes | yes (native audio) |
-| **Fixed camera** | yes | — |
-| **Negative prompt** | — | yes |
+- `seedance-mini` / `seedance-2.0-mini` → Seedance-2.0-mini
+- `seedance-fast` / `seedance-2.0-fast` → Seedance-2.0-fast
+- `seedance` / `seedance-2.0` → Seedance-2.0
+
+Veo 3.1 / Veo 3.1 Fast are **not available** — there is no working Veo channel on the gateway,
+so they are absent from the catalog and `--model veo` will fail.
+
+### Parameter ranges (identical across the three tiers, except resolution)
+
+| | Seedance 2.0 mini / fast / standard |
+|--|--|
+| **Aspect ratio** | `adaptive` `16:9` `4:3` `1:1` `3:4` `9:16` `21:9` |
+| **Resolution** | `480p` `720p` (`1080p` on `seedance` only) |
+| **Duration** | 4–15 seconds (continuous integers) |
+| **First / last frame** | yes |
+| **Reference images** | yes, up to 9 |
+| **Generated audio** | yes |
+| **Fixed camera** | yes |
+| **Negative prompt** | ignored (Veo-only parameter) |
 
 ## Auth & environment
 
@@ -61,7 +66,7 @@ No skill-local env file — the executing process inherits the system environmen
 | Env var | Description | Default |
 |---------|-------------|---------|
 | `PRIV_TOKEN` | Tianyan token; `--priv-token` overrides | none |
-| `MM_VIDEO_MODEL` | Default model id | `doubao-seedance-1-5-pro-251215` |
+| `MM_VIDEO_MODEL` | Default model id or shortcut | catalog default (`seedance-mini`) |
 | `MM_API_BASE_URL` | API root; `--api-base-url` overrides | `https://api.remixmate.com/api` |
 | `AGENT_NAME` | Optional `x-invoke-agent` header | none |
 
@@ -71,7 +76,7 @@ No skill-local env file — the executing process inherits the system environmen
 2. **Async job**: video generation is async; the handler polls until completion (typically 1–3 minutes) and emits `__progress__` lines.
 3. **Surface results**: stdout prints the video URL on its own line; show it directly to the user (no download needed — the URL is cloud-persisted).
 
-### Seedance text-to-video (default model)
+### Text-to-video (default model: Seedance-2.0-mini)
 
 ```bash
 remixmate gen-video \
@@ -80,7 +85,7 @@ remixmate gen-video \
   --ratio "16:9"
 ```
 
-### Seedance first/last frame + audio
+### First/last frame + audio
 
 Frame images accept local file paths, HTTPS URLs, or data URIs (local files are base64-encoded into a data URI).
 
@@ -93,33 +98,25 @@ remixmate gen-video \
   --generate-audio
 ```
 
-### Veo 3.1 high-resolution
+### 1080p final cut
+
+Only `seedance` (the standard tier) offers 1080p; it also costs roughly twice mini per second.
 
 ```bash
 remixmate gen-video \
-  --model veo \
+  --model seedance \
   --prompt "<video description>" \
   --duration 8 \
   --ratio "16:9" \
-  --resolution 4k
-```
-
-### Veo 3.1 Fast for rapid iteration
-
-```bash
-remixmate gen-video \
-  --model veo-fast \
-  --prompt "<video description>" \
-  --duration 6
+  --resolution 1080p
 ```
 
-### Veo with reference images
+### With reference images
 
-Pass `--reference` multiple times (Veo only, up to 3).
+Pass `--reference` multiple times (up to 9).
 
 ```bash
 remixmate gen-video \
-  --model veo \
   --prompt "<video description>" \
   --reference ./ref1.png \
   --reference ./ref2.png \
@@ -131,16 +128,16 @@ remixmate gen-video \
 | Flag | Description | Default |
 |------|-------------|---------|
 | `-p` / `--prompt` | Video description (combinable with first/last frame or references) | — |
-| `-m` / `--model` | Model id or shortcut (`seedance` / `veo` / `veo-fast`) | see `MM_VIDEO_MODEL` |
-| `-d` / `--duration` | Duration in seconds. Defaults to 5 (Seedance) or 8 (Veo) when omitted | per model |
-| `-r` / `--ratio` | Aspect ratio (default `16:9`). Seedance also accepts `adaptive` | `16:9` |
-| `--resolution` | Resolution. Veo accepts `4k` | `720p` |
+| `-m` / `--model` | Model id or shortcut (`seedance-mini` / `seedance-fast` / `seedance`) | see `MM_VIDEO_MODEL` |
+| `-d` / `--duration` | Duration in seconds (4–15) | 5 |
+| `-r` / `--ratio` | Aspect ratio; `adaptive` also accepted | `16:9` |
+| `--resolution` | Resolution. `1080p` only on `seedance` | `720p` |
 | `--first-frame` | First-frame image: local path, https URL, or data URI | none |
 | `--last-frame` | Last-frame image | none |
-| `--reference` | Reference image (repeatable; Veo only, max 3) | none |
+| `--reference` | Reference image (repeatable, max 9) | none |
 | `--generate-audio` | Generate native audio | off |
-| `--camera-fixed` | Fixed camera (mainly Seedance) | off |
-| `--negative-prompt` | Negative prompt (mainly Veo) | none |
+| `--camera-fixed` | Fixed camera | off |
+| `--negative-prompt` | Negative prompt (Veo only; ignored by Seedance) | none |
 | `--seed` | Random seed | none |
 | `--person-generation` | Person policy: `allow_all` / `dont_allow` (Veo) | none |
 | `--api-base-url` | Override API root | see above |

package/skills/gen-video/skill.json

@@ -4,7 +4,7 @@
   "tier": "atomic",
   "category": "asset",
   "title": "AI Video Generation",
-  "description": "AI video generation: produce a short video clip from a text prompt. Supports Seedance and Veo models, plus first/last frame and reference images.",
+  "description": "AI video generation: produce a short video clip from a text prompt. Three Seedance 2.0 tiers (mini / fast / standard), plus first/last frame and reference images.",
   "auth": "required",
   "joinsTake": true,
   "envVars": [
@@ -26,7 +26,7 @@
       },
       "model": {
         "type": "string",
-        "description": "Model: 'seedance' (default; 4-12s, adaptive/21:9 ratios, fixed camera), 'veo' (4/6/8s, native audio, up to 4k, reference images), or 'veo-fast' (faster Veo variant for iteration)"
+        "description": "Model: 'seedance-mini' (default; cheapest, 480p/720p), 'seedance-fast' (480p/720p), or 'seedance' (Seedance 2.0, adds 1080p). All are 4-15s and share the same features"
       },
       "duration": {
         "type": "number",
@@ -53,7 +53,7 @@
         "items": {
           "type": "string"
         },
-        "description": "Reference images: local file path, https URL, or data URI. Veo only, max 3 — Seedance rejects them, use first_frame / last_frame instead."
+        "description": "Reference images: local file path, https URL, or data URI. Up to 9; combinable with first_frame / last_frame."
       },
       "generate_audio": {
         "type": "boolean",
@@ -65,7 +65,7 @@
       },
       "negative_prompt": {
         "type": "string",
-        "description": "Content to steer away from (Veo)"
+        "description": "Content to steer away from. Veo only — Seedance ignores it (kept for when a Veo channel is available again)"
       },
       "seed": {
         "type": "number",
@@ -101,12 +101,12 @@
       "last_frame",
       "reference",
       "generate_audio",
-      "camera_fixed",
-      "negative_prompt"
+      "camera_fixed"
     ],
     "hidden": [
       "json_output",
       "seed",
+      "negative_prompt",
       "person_generation"
     ]
   }

package/skills/gen-video/version.json

@@ -2,6 +2,6 @@
   "skillName": "gen-video",
   "repoName": "agent-skill-media-maker",
   "skillId": "339",
-  "version": "V8",
-  "skillDescription": "AI video generation skill: produce a short clip from a text prompt. Backed by ab-api's `/model/genVideo` (Seedance and Veo families).\n\nUse this skill immediately whenever the user asks for any of:\n- Text-to-video, AI-generated clip, \"make a short video of ...\"\n- Generate video with Doubao / Seedance / Veo / Google\n- Image-to-video, first-frame / last-frame, reference-image-to-video\n\nEven without an explicit \"use AI\", any request that turns a description into a moving clip should route here."
+  "version": "V9",
+  "skillDescription": "AI video generation skill: produce a short clip from a text prompt. Backed by ab-api's `/model/genVideo` (Seedance 2.0 family).\n\nUse this skill immediately whenever the user asks for any of:\n- Text-to-video, AI-generated clip, \"make a short video of ...\"\n- Generate video with Doubao / Seedance\n- Image-to-video, first-frame / last-frame, reference-image-to-video\n\nEven without an explicit \"use AI\", any request that turns a description into a moving clip should route here."
 }

package/skills/template-registry/scripts/match_template.py

@@ -183,6 +183,16 @@ def build_binding(template: dict, dsl: dict) -> dict:
     motion = template.get("defaultMotionPreset", "smooth")
     colors = template.get("defaultColorScheme", [])
 
+    # 用户选中的字体（DSL 的 global.font）。这里只是把不透明 key 折进 typography，
+    # 真正的解析（uniqId → 排印家族名 + 字重文件）在 ab-render 侧完成。
+    #
+    # 优先级见 ab-platform/docs/font-selection-design.md §13.3：
+    #   用户选择 > variant.defaultFontId（预留档位，当前恒为空）
+    #     > template.defaultTypography.bodyFont（现状裸 family 名）> 模板 theme 字栈
+    # 下面的 variant 合并在此之后执行，所以 fontId 单独在合并后再写回，
+    # 避免被 variant 的 defaultTypography 覆盖掉。
+    user_font_id = ((dsl.get("global", {}) or {}).get("font", {}) or {}).get("fontId")
+
     # --- variant selection（确定性）---
     # 优先级：
     #   1) DSL 显式声明 — meta.templateVariant / meta.variant / renderHints.templateVariant
@@ -268,6 +278,10 @@ def build_binding(template: dict, dsl: dict) -> dict:
         if vcolors:
             colors = vcolors
 
+    # 用户的字体选择压过 variant 默认值（§13.3 的优先级第一档），所以写在合并之后。
+    if isinstance(user_font_id, str) and user_font_id.strip():
+        typography = {**typography, "fontId": user_font_id.strip()}
+
     result = {
         "version": "v1alpha1",
         "templateId": template.get("templateId", ""),

package/skills/template-registry/video_dsl/schema/video-dsl-v1alpha1.json

@@ -105,6 +105,17 @@
             "url": { "type": "string" },
             "volume": { "type": "number", "default": 0.15, "minimum": 0, "maximum": 1 }
           }
+        },
+        "font": {
+          "type": "object",
+          "description": "全局字体选择。省略 = 跟随模板自带的字体搭配。match_template 会把它折进 binding 的 globalOverrides.typography。",
+          "properties": {
+            "fontId": {
+              "type": "string",
+              "description": "字体库的不透明 key（font.uniq_id）。**不要在这里写 CSS family 名**：family 名是渲染细节，由 ab-render 调 /font/resolve 解析；写成 family 名一旦拼错就静默退回默认字体，没有任何报错。见 ab-platform/docs/font-selection-design.md §8.1。"
+            },
+            "fontName": { "type": "string", "description": "展示名，仅供人读与日志，渲染不使用" }
+          }
         }
       }
     },