org.noear.solon.ai.skills.generation

类 VideoGenerationSkill

java.lang.Object

org.noear.solon.ai.chat.skill.AbsSkill

org.noear.solon.ai.skills.generation.VideoGenerationSkill

所有已实现的接口:

Skill

@Preview(value="3.9.1")
public class VideoGenerationSkill
extends AbsSkill

视频生成技能：为 AI 提供多模态视频创作能力。

该技能集成了先进的视频生成驱动（如 Sora, Kling, Luma 等），支持根据文本描述合成短视频。 核心设计要点：

• 成本感知：通过意图识别，仅在明确需要视频创作时触发，避免昂贵的 Token/API 浪费。
• 规格约束：支持动态指定时长与宽高比，适配社交媒体（9:16）或传统荧幕（16:9）。
• 异步兼容性：考虑到视频生成的长耗时特征，驱动接口建议实现为内部轮询至下载完成，确保 Agent 拿到的是最终可用的本地物理文件。

从以下版本开始:

3.9.1

嵌套类概要

嵌套类

限定符和类型	类和说明
static interface	VideoGenerationSkill.VideoDriver 视频生成驱动接口

字段概要

字段

限定符和类型	字段和说明
static VideoGenerationSkill.VideoDriver	SORA 模拟 Sora 驱动实现

从类继承的字段 org.noear.solon.ai.chat.skill.AbsSkill

tools

构造器概要

构造器

构造器和说明
VideoGenerationSkill(VideoGenerationSkill.VideoDriver driver, java.lang.String apiKey, java.lang.String workDir)

方法概要

限定符和类型	方法和说明
java.lang.String	description() 获取技能描述
java.lang.String	generate(java.lang.String prompt, java.lang.Integer seconds, java.lang.String aspectRatio, java.lang.String fileName) 执行视频生成
boolean	isSupported(Prompt prompt) 准入检查：决定该技能在当前对话上下文中是否被激活
java.lang.String	name() 获取技能名称（默认类名）

从类继承的方法 org.noear.solon.ai.chat.skill.AbsSkill

getTools, metadata

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

从接口继承的方法 org.noear.solon.ai.chat.skill.Skill

getInstruction, onAttach

字段详细资料

SORA

public static final VideoGenerationSkill.VideoDriver SORA

模拟 Sora 驱动实现

构造器详细资料

VideoGenerationSkill

public VideoGenerationSkill(VideoGenerationSkill.VideoDriver driver,
                            java.lang.String apiKey,
                            java.lang.String workDir)

方法详细资料

name

public java.lang.String name()

从接口复制的说明: Skill

获取技能名称（默认类名）

description

public java.lang.String description()

从接口复制的说明: Skill

获取技能描述

isSupported

public boolean isSupported(Prompt prompt)

从接口复制的说明: Skill

准入检查：决定该技能在当前对话上下文中是否被激活

参数:

prompt - 当前提示词上下文

返回:

true 表示激活并挂载该技能

generate

@ToolMapping(name="generate_video",
             description="\u6839\u636e\u6587\u5b57\u63d0\u793a\u8bcd\u751f\u6210\u4e00\u6bb5\u77ed\u89c6\u9891\u5e76\u4fdd\u5b58\u3002\u5efa\u8bae\u6307\u5b9a\u6bd4\u4f8b\uff1a\u6a2a\u5c4f 16:9\uff0c\u7ad6\u5c4f 9:16\u3002")
public java.lang.String generate(@Param(value="prompt")
                                                                                                                                                                                                                                                                                                      java.lang.String prompt,
                                                                                                                                                                                                                                                                                                      @Param(value="seconds")
                                                                                                                                                                                                                                                                                                      java.lang.Integer seconds,
                                                                                                                                                                                                                                                                                                      @Param(value="aspectRatio")
                                                                                                                                                                                                                                                                                                      java.lang.String aspectRatio,
                                                                                                                                                                                                                                                                                                      @Param(value="fileName")
                                                                                                                                                                                                                                                                                                      java.lang.String fileName)

执行视频生成

参数:

prompt - 视频内容描述

seconds - 期望时长（秒），可选，默认 5 秒

aspectRatio - 视频比例（如 16:9, 9:16），可选，默认 16:9

fileName - 建议的文件名（如 promo.mp4）