HiAPI 视频提示生成器

使用本技能前，请在每次会话中运行一次更新检查（离线时自动静默跳过；设置 HIAPI_SKIP_UPDATE_CHECK=1 可禁用）：

node scripts/check-update.mjs

若报告存在**必需更新**，请先执行所显示的安装命令，再继续；若仅报告存在**可用更新**，请告知用户并继续执行。

当用户提供视频创意、产品链接、研究主题或简要需求，并需要一个强效、可直接执行的视频提示（prompt）以调用视频模型时，请使用本技能。

本技能**不生成视频**，而是输出结构化提示，用户可将其粘贴至以下任一技能中：

• hiapi-seedance-2-0-video-skill — 高质量文本转视频（text-to-video）与图像转视频（image-to-video）。
• hiapi-happyhorse-1-0-video-skill — 轻量级文本转视频草稿（text-to-video drafts）。

输出内容经专门设计，确保每个事实、每条命令及每个 UI 标签均能完整无损地传递至视频模型。

适用场景

当满足以下任一条件时，请使用本技能：

• 用户描述了想要制作的视频，但需求仅有一两句话，过于简略。
• 用户提供 URL、GitHub 仓库或文档，并要求“为此内容制作一个视频”。
• 用户需要制作产品演示、教学短视频、社交媒体短视频、解释类视频或推介视频（pitch）。
• 用户提供了一个初步提示，但该提示模糊、泛化，或缺少屏幕文字（on-screen text）与运动描述（motion）。

若用户已拥有最终确定的提示，且仅需生成视频，则跳过本技能，直接路由至对应模型技能。

默认配置

• 时长：默认为 5 秒。切勿默认设为 30 秒 — HiAPI 的视频模型不支持该长度。
• 画幅比（Aspect）：水平型演示或解释类视频使用 16:9；社交媒体短视频或垂直向产品预告使用 9:16。
• 分镜数量：
  • 微剪辑粒度（Seedance 2.0）：5 秒时为 4 个分镜块，8 秒时为 5 个，10 秒时为 6 个，15 秒时最多为 8 个。
  • 宏节奏粒度（HappyHorse 1.0）：3 秒时为 2 个节奏点，5 秒时为 3 个，8 秒时为 4 个，10 秒时为 5 个，15 秒时为 6 个。
  无论采用哪种粒度，输出协议（Output Contract）始终按“每场景一个分镜块”返回。
• 分辨率：
  • Seedance 2.0 默认为 720p；对快速草稿可降级为 480p。
  • HappyHorse 1.0 默认为 1080p；当速度或成本敏感时可降级为 720p；不得为 HappyHorse 输出 480p。
• 语言：匹配用户的语言。产品名、命令、UI 标签等须保持原始大小写格式。

所支持的参数集是模型专属的。本技能必须首先选定目标模型，再将时长与画幅比约束于该模型所允许的取值范围内。

Seedance 2.0（hiapi-seedance-2-0-video）

• 时长（秒）：任意整数，范围为 4 至 15。
• 分辨率：480p、720p、1080p。
• 画幅比（标志 --ratio）：16:9、9:16、1:1、4:3、3:4、21:9、adaptive。
• 媒体模式：文本转视频；首帧图像转视频；首帧+末帧图像转视频；多模态参考（multimodal references）。
• 互斥规则：禁止将首帧/末帧字段与 reference_image_urls、reference_video_urls 或 reference_audio_urls 混用。
• 参考资源限制：
  • 参考图像 + 首帧/末帧图像总数 ≤ 9 张；
  • 参考视频 ≤ 3 段，每段时长 2–15 秒，总时长 ≤ 15 秒；
  • 参考音频 ≤ 3 段，每段时长 2–15 秒，总时长 ≤ 15 秒。

HappyHorse 1.0（hiapi-happyhorse-1-0-video）

• 时长（秒）：任意整数，范围为 3 至 15。
• 分辨率：720p、1080p。
• 尺寸（标志 --size，非 --ratio）：16:9、9:16、1:1、4:3、3:4；不支持 21:9。
• 随机种子（Seed）：可选整数，范围为 0 至 2147483647；仅当用户明确要求结果可复现时才包含。
• 输入类型：仅支持文本转视频（text-to-video）；不支持图像输入。

工作流程

1. 阅读请求。对其分类：产品演示、教学短视频、社交媒体短视频、解释类视频、推介视频、历史类视频，或视觉概念类视频。
2. 选择目标模型。默认选用 hiapi-seedance-2-0-video，适用于图像转视频、追求电影感，或视频时长超过 5 秒的场景；若需快速生成文本转视频草稿，则选用 hiapi-happyhorse-1-0-video。
3. 收集资料源。优先使用用户提供的材料；若信息不足，则开展调研：
   • 官方产品网站、文档、GitHub 仓库、发布说明（release notes）。
   • 主题的一手资料（如论文、组织官网、官方档案库）。
   • 必要时补充权威英文背景资料。
   • 避免引入用户未要求的资料源，以防稀释或违背原始需求。
4. 提取可视觉化的事实。参见 references/source-extraction.md。提取名称、命令、UI 标签、数字、差异化特性、视觉钩子（visual hooks），以及产品绝不可声称的内容。
5. 选择提示模板。参见 references/prompt-patterns.md。根据选定的时长与画幅比调整模板。
6. 撰写提示，严格遵循下方“输出协议（Output Contract）”。每个事实、命令与 UI 标签，必须以屏幕文字、旁白或带标签的视觉提示形式显式呈现。
7. 验证约束条件：
   • 确认时长在所选目标模型允许范围内（Seedance：4–15 秒整数；HappyHorse：3–15 秒整数）；
   • 确认画幅比值符合目标模型对应标志（Seedance 用 --ratio，HappyHorse 用 --size），且在允许列表内；
   • 对 Seedance，须精确选择一种媒体模式：首帧、首帧+末帧，或多模态参考；
   • 在编写交接命令前，确认参考图像/视频/音频数量未超限；
   • 确认屏幕文字足够简短，可在指定时间内清晰渲染；
   • 确认提示中未虚构任何功能。
8. 交接执行。参见 references/hiapi-handoff.md。向用户提供针对所选 HiAPI 技能的完整 node scripts/... 命令，供其下一步直接运行。

输出协议

按以下顺序，以用户语言返回全部下列章节；章节标题也须使用用户语言。

1. 视频类型 — 从以下选项中择一：产品演示、教学短视频、社交媒体短视频、解释类视频、推介视频、历史类视频、视觉概念类视频。
2. 目标模型 — hiapi-seedance-2-0-video 或 hiapi-happyhorse-1-0-video，并附一条简明理由。
3. 时长与画幅比 — 从所选目标模型的允许列表中选取：
   • Seedance：时长为 4 至 15 秒任意整数，画幅比为 16:9|9:16|1:1|4:3|3:4|21:9|adaptive 中之一；
   • HappyHorse：时长为 3 至 15 秒任意整数，画幅比为 16:9|9:16|1:1|4:3|3:4 中之一。
   明确指出目标模型所用标志（Seedance 为 --ratio，HappyHorse 为 --size）。
4. 核心目标 — 一句话：观众在视频结束时应记住的关键信息。
5. 资料源提取摘要 — 5 至 10 条要点，每条标注 [source]（若源自真实资料）或 [creative assumption]（若为布景所需而创造性假设）。切勿将猜测误标为资料源。
6. 叙事主线 — 一句话：从第一帧到最后一帧的故事脉络。
7. 分镜提示 — 每个分镜一个独立区块。每个区块包含：
   • Time（例如 0.0s–1.2s）
   • Visual — 屏幕上呈现的内容
   • On-Screen Text — 精确字符串，加英文双引号，长度须适配对应时长
   • Action / Camera — 一种主导运动 + 一种次要环境运动
   • Narration — 一句简短旁白，或 (none)
   • Transition — 到下一场景的转场方式
8. 必需屏幕文字 — 所有引用的屏幕文字字符串去重后列表。保留命令语法，文字标签须完全一致。
9. 运动与摄像机控制 — 列出主导运动类型（如打字、点击、缩放、平移、推轨、揭示）。除非需求明确为艺术风格，否则避免粒子特效。
10. 风格要求 — 色彩、光影、字体排印、画面密度、情绪氛围。一段文字描述。
11. 否定约束 — 模型严禁呈现的内容。必须包含：不得虚构功能；不得出现需求未授权的 Logo；不得出现“必需屏幕文字”以外的任何屏幕文字。
12. 最终可交付提示 — 一段紧凑文本，适合作为 --prompt 参数输入。它必须：
    • 保持分镜顺序，并含简短时间标记（如 [0–1.2s]）；
    • 逐字包含全部“必需屏幕文字”字符串；
    • 体现主导运动；
    • 至少包含一条“否定约束”。
    若仅提供扁平化描述而遗漏上述要素，则视为错误。
13. 交接命令 — 针对所选 HiAPI 技能的完整 node scripts/... 命令，其中已预填时长、分辨率、媒体模式，以及正确的画幅比标志（Seedance 用 --ratio，HappyHorse 用 --size）。命令前缀为用户需首先 cd 进入的工作目录（即已安装的目标技能所在目录）。

质量标准

高质量输出是导演式（directed）而非描述式（described）。它明确告诉模型：什么出现、什么运动、什么被输入、什么被听见、什么基于资料源、什么绝对不可出现。若“资料源提取摘要”中某项事实未在屏幕文字、旁白或带标签的视觉提示中体现，则应删除该项，或新增分镜予以呈现。

严禁虚构事实。产品名、指标数据、命令、UI 标签、版本号、用户证言、功能主张等，必须源自用户需求或已引用资料源。仅布景选择（如摄像机角度、版式布局、灯光、通用视觉处理、转场文案）在无资料源明确支撑时，方可标注为 [creative assumption]。缺失的事实应作为问题反馈给用户，而非擅自编造。

路由逻辑与关联技能

• 若需为图像转视频准备静态起始帧（still image starting frame），请先路由至 awesome-gpt-image-2-prompts 生成图像提示，再通过 hiapi-gpt-image-2-skill 渲染图像。
• 若需参考经过验证的视频提示库（library of proven video prompts）作为锚点，请查阅 awesome-seedance-2-0-prompts。
• 若需进行更广泛的模型发现（broader model discovery），请查阅 hiapi-skills 或远程 MCP 地址：https://mcp.hiapi.ai/mcp。

示例

$hiapi-video-prompt-generator 将 https://github.com/HiAPIAI/hiapi-skills 转换为一段 5 秒的产品介绍视频。

$hiapi-video-prompt-generator 制作一段 9:16 画幅的社交媒体短视频，说明为何 agent 技能优于单次提示（one-shot prompts）。

$hiapi-video-prompt-generator 基于 outputs/product.png 启动一段 8 秒的图像转视频，采用柔和摄像机运动与影棚灯光。

重要链接

• HiAPI Seedance 2.0 视频技能：https://github.com/HiAPIAI/hiapi-seedance-2-0-video-skill
• HiAPI HappyHorse 1.0 视频技能：https://github.com/HiAPIAI/hiapi-happyhorse-1-0-video-skill
• 获取 API 密钥：https://www.hiapi.ai/en/register
• 定价信息：https://www.hiapi.ai/en/pricing
• HiAPI 文档：https://docs.hiapi.ai