WeryAI 视频生成器

使用官方基础技能生成 WeryAI 视频，支持文本生成视频（text-to-video）、图像生成视频（image-to-video）、单图生成视频（video from image）、分镜生成视频（storyboard-to-video），以及首帧到末帧过渡视频（first-frame/last-frame transition）等工作流。在 agent 环境中，默认采用“结果优先”（result-first）执行模式：提交任务后进行有界轮询，直至可播放视频就绪或超时。请使用有界等待（短任务：10 分钟；长任务：30 分钟），避免无界轮询循环。

示例提示词

• 生成一段 WeryAI 文本生成视频片段，并在超时前返回最终可播放视频。
• 将这张图像转为带有细微运动的视频，并通过有界轮询等待最终输出。
• 生成一段从该首帧过渡到该末帧的视频。
• 将这些分镜帧合成为一段连贯的产品发布视频。
• 在提交前，先查询哪些 WeryAI 视频模型支持 10 秒时长、16:9 画幅比及音频生成能力。

快速概览

• 核心任务类型：text-to-video、image-to-video、video from image、first-frame to last-frame video、storyboard-to-video、task status
• 默认模型：Seedance 2.0（SEEDANCE_2_0）
• 默认参数：duration=5、resolution=720p、aspect_ratio=9:16、generate_audio=true（仅对支持音频的模型生效）
• 主要可信信号：支持 dry-run 模式、模型能力查询、付费运行前警告、媒体源校验（本地引用自动上传）

认证与首次配置

首次真实生成前，请完成以下步骤：

1. 注册一个 WeryAI 账户。
2. 访问 API 密钥页面：https://www.weryai.com/api/keys。
3. 创建一个新的 API 密钥，并复制其密钥值（secret value）。
4. 将其设置为必需的环境变量 WERYAI_API_KEY。
5. 确保 WeryAI 账户在发起付费生成前已有可用余额或积分。

OpenClaw 友好型配置

• 本技能已在 metadata.openclaw.requires.env 和 primaryEnv 中声明了 WERYAI_API_KEY。
• 安装完成后，若安装器或运行时提示需提供必需的环境变量，请将密钥粘贴至 WERYAI_API_KEY 字段。
• 如需手动配置运行时，请在执行命令前导出该变量：

export WERYAI_API_KEY="your_api_key_here"

快速验证

首次付费运行前，建议执行一次安全检查：

node {baseDir}/scripts/models-video.js --mode text_to_video
node {baseDir}/scripts/wait-video.js --json '{"prompt":"一条发光锦鲤游过墨色云团","duration":5}' --dry-run

• models-video.js 用于确认密钥已正确配置且模型接口可正常访问。
• --dry-run 可在本地预览请求结构，不消耗积分。
• 真实的 wait 或 submit-* 命令仍需账户具备可用的 WeryAI 余额。

前置条件

• 付费运行前必须设置 WERYAI_API_KEY。
• 需要 Node.js >=18，因运行时依赖内置 fetch API。
• 参考媒体（image、images、videos、audios）可为 http/https URL 或本地文件路径；本地或非 HTTP(S) 来源将首先通过 /v1/generation/upload-file 接口上传。
• 真实的 submit 和 wait 命令将消耗 WeryAI 积分。

安全性与 API 主机

• 请严格保密 WERYAI_API_KEY，切勿将其写入代码仓库。
• 可选覆盖项 WERYAI_BASE_URL 和 WERYAI_MODELS_BASE_URL 默认分别指向 https://api.weryai.com 和 https://api-growth-agent.weryai.com；仅可在确认可信的前提下覆盖为其他主机地址。
• 如需更高保障，请在生产环境中使用前审阅 scripts/ 目录下的脚本。

支持的意图类型

• 纯文本描述 → 从零生成视频。
• 单张参考图像 → 将源图像动态化为视频。
• 起始帧 + 结束帧 → 生成受控过渡视频。
• 多张有序图像 → 将分镜或镜头序列合成单个视频。
• 已有任务 ID → 查询状态，而非新建付费任务。
• 参数或模型相关问题 → 先查询 models 接口，再提交生成请求。

默认配置

除非用户显式修改，否则优先采用以下默认值：

• model：SEEDANCE_2_0（SEEDANCE_2_0）
• duration：5
• resolution：720p
• aspect_ratio：9:16
• generate_audio：true（仅对支持音频的模型生效）

始终允许用户覆盖 model、duration、resolution、aspect_ratio 和 generate_audio。当用户请求不被支持的设置时，请调用 models-video.js 查询，并仅保留所选模型实际支持的参数值。

模型切换与参数引导策略

应采用渐进式引导方式，而非一次性解释所有参数。

• 若用户仅要求生成视频，则直接使用默认的 Seedance 2.0（SEEDANCE_2_0）配置启动。
• 若用户提出更换模型、提升画质、增强运动生成、延长时长、横屏/竖屏输出或启用音频等需求，则进入参数确认模式。
• 若用户已明确指定所需参数，则直接应用，并仅在必要时校验模型兼容性。
• 若用户表达模糊，应将其创意需求映射为最接近的支持参数，而非要求其自行选择原始 API 字段。

推荐的引导范式

采用简明的操作员风格引导语，例如：

• 通用帮助：当用户询问“如何使用此技能”时，切勿粘贴原始 shell 命令；而应以自然语言说明能力范围，并提供 2–3 个提示词示例（例如：“您可以让我为肖像图添加动画效果……”）。
• 默认运行： 我可基于默认配置启动：Seedance 2.0（Seedance 2.0）、5 秒时长、720p 分辨率、9:16 画幅比、启用音频（仅对支持音频的模型生效）。您也可在提交前随时切换模型，或调整时长、画幅比、分辨率和音频设置。
• 模型切换： 若您希望更换模型，请告知您更关注图像质量、运动生成性能、首末帧控制能力、多图支持，还是成本/速度权衡，我将首先查询各模型的支持能力。
• 参数变更： 我可以将您的需求映射为具体视频参数。例如：竖版短视频 → 9:16；横版 → 16:9；更长片段 → 10 秒或 15 秒；添加环境音 → generate_audio=true。
• 付费运行前的安全确认： 在我提交付费任务前，我会展示最终选定的模型、参数与提示词，供您确认。

何时发起追问

仅在提交任务所必需的最小缺失信息层面发起追问。

• 当用户提及 TikTok、Reels、YouTube Shorts 或横版预告片等平台意图时，询问 aspect_ratio 设置。
• 当用户明确要求更长片段或更慢节奏时，询问 duration 设置。
• 对支持音频的模型，默认启用 generate_audio，除非用户明确要求静音。
• 仅当用户主动提出更换模型，或当前模型能力支持存在不确定性时，才询问模型选择。
• 若默认配置已完全满足用户请求，则无需逐项询问所有参数。

用户语言到参数的映射规则

常用映射如下：

• vertical、portrait、short video、TikTok、Reels、Shorts → aspect_ratio: 9:16
• square → aspect_ratio: 1:1
• landscape、widescreen、YouTube、cinematic frame → aspect_ratio: 16:9
• make it longer、slower pacing → 将 duration 提升至支持值（如 10 或 15）
• make it clearer、higher quality → 对所选模型启用其支持的最高 resolution
• add ambient sound、with audio → generate_audio: true
• use another model、not Seedance、check supported models → 提交前先运行 models-video.js

模型查询工作流

当用户提出更换模型，或请求可能不受支持的参数时：

1. 识别目标模式：text_to_video、image_to_video 或 multi_image_to_video。
2. 首先运行对应版本的 models-video.js 命令。
3. 仅保留所选模型支持的 duration、aspect_ratio、resolution 和音频支持参数值。
4. 若多个模型均满足条件，推荐一个简洁默认选项，而非直接输出原始元数据（除非用户明确要求对比）。
5. 若支持情况不明确，请明确说明，并在付费调用前使用 --dry-run 或安全模型查询进行验证。

提交前的确认区块

付费运行前，需展示包含最终载荷选择的简洁确认区块：

准备生成

- mode: `image-to-video`
- model: `SEEDANCE_2_0` (`Seedance 2.0`)
- duration: `5`
- resolution: `720p`
- aspect_ratio: `9:16`
- generate_audio: `true` (for audio-capable models)
- image: `https://example.com/input.png`
- prompt: `Animate this portrait with subtle hair and fabric motion, preserve identity, keep the composition stable, soft side lighting, gentle camera drift, clean final hold on the face.`

请等待用户确认或提出修改意见后，再执行付费提交。

意图路由

默认采用“结果优先”执行路径，尽可能向用户提供最终可播放输出。

• 若用户仅提供 prompt，则路由至 text-to-video。
• 若用户仅提供 image，则路由至 image-to-video。
• 若用户提供 first_frame + last_frame，或 image + last_image，则标准化为有序 images 数组，并路由至多图引导流程。
• 若用户提供 images，则路由至 multi-image-to-video。
• 若所选模型不支持多图输入，运行时可能自动降级为仅使用首张图像的 image-to-video。
• 默认运行路径：
  1. 运行 wait-video.js（提交 + 有界轮询），就绪后返回最终视频。
  2. 若超时，则返回 taskId/batchId 及后续状态查询命令。
• 仅当用户明确要求“创建任务但不等待”时，才使用 submit-* 类命令。

推荐命令

# 默认有界等待（结果优先）
node {baseDir}/scripts/wait-video.js --json '{"prompt":"夜晚霓虹都市穿梭镜头","duration":5}'

# 轮询已有任务状态
node {baseDir}/scripts/status-video.js --task-id 

工作流

1. 识别用户意图：纯文本、单图、首/末帧、多图、状态查询或模型查询。
2. 收集 prompt，并按需获取有序的公开 https 图像 URL。
3. 应用默认配置：Seedance 2.0（SEEDANCE_2_0）、5s、720p、9:16，以及对支持音频的模型启用 generate_audio=true（除非用户另有要求）。
4. 若用户要求自定义模型或非默认参数，且兼容性不确定，则优先运行 models-video.js。
5. 如需在付费提交前预览最终载荷，请使用 --dry-run。
6. 默认采用有界等待执行：
   • 阶段一：对生成请求运行 wait-video.js（提交 + 轮询）。
   • 阶段二：在超时内就绪时，返回可播放视频 URL。
   • 阶段三：若超时，向用户返回 taskId 并询问是否需要再次查询状态。切勿向用户展示原始 node 状态命令，仅在内部调用。
7. 仅当用户明确要求“创建任务但不等待”时，才使用 submit-* 类命令。
8. 使用 status-video.js 安全地重新检查已有任务或批次状态。

轮询超时分类

• short 类任务：text_to_video，默认超时 10 分钟（600000ms）。
• long 类任务：image_to_video、multi_image_to_video、almighty_reference_to_video，默认超时 30 分钟（1800000ms）。
• auto 类任务（默认）根据实际提交模式自动映射。
• WERYAI_POLL_TIMEOUT_MS 仍为最高优先级的显式覆盖项，用于兼容性保障。
• 可选环境变量覆盖：
  • WERYAI_SHORT_TASK_TIMEOUT_MS
  • WERYAI_LONG_TASK_TIMEOUT_MS

输入规则

• 所有生成模式均强制要求 prompt 和 duration。
• image、images、first_frame、last_frame 和 last_image 必须为公开 https URL。
• 若同时提供 images 和 image，则在模式识别阶段以 images 为准。
• first_frame + last_frame 与 image + last_image 均视为首末帧意图的合法别名。
• 仅在所选模型支持的前提下，才发送 aspect_ratio、resolution、negative_prompt 或 generate_audio。
• 不得引入未文档化的字段。

输出规范

所有命令均向 stdout 输出 JSON。成功响应可能包含：

• taskId、taskIds、batchId
• taskStatus
• videos
• requestSummary
• balance
• errorCode、errorMessage

面向用户的交付要求：

• 若存在视频 URL，至少返回一个可播放的 Markdown 链接（例如 [Video](https://...)）；若生成多个视频，则依次渲染全部链接。
• 除视频输出外，还应附带关键生成参数（如可用）：model、duration、aspect_ratio、resolution、generate_audio。
• 若发生超时，返回 taskId 并询问用户是否需要再次查询状态。切勿向用户展示原始 node 状态命令，仅在内部调用。

详见 references/error-codes.md 获取常见错误类别及恢复建议。

完成标准（Definition Of Done）

当满足以下任一条件时，即视为任务完成：

• 本地校验通过，CLI 端无报错；
• wait-video.js 进入终态并至少返回一个可播放视频 URL；
• 有界等待超时，返回 taskId 并提供后续状态重查选项；
• status-video.js 返回清晰的“处理中”或“终态”响应；
• 输出内容明确指出是否存在视频 URL。

约束条件

• 不可假设所有模型均支持全部参数。
• 不可对参考图像使用本地文件路径。
• 不可随意重复执行 submit 或 wait，因每次执行均可能创建新的付费任务。
• 在 agent 环境中，对长时间运行的生成任务，不应默认使用 wait-video.js。
• 不得将本技能扩展为超出 WeryAI API 文档范围的一般性视频编辑功能。

重试行为

• submit-text-video.js、submit-image-video.js 和 submit-multi-image-video.js 均不具有幂等性。
• wait-video.js 同样不具幂等性，因其先提交任务再轮询状态。
• status-video.js、models-video.js 和 balance-video.js 可安全重试。

参考资料

• 模型元数据与参数规则：references/api-models.md
• 错误处理指南：references/error-codes.md