@happyvertical/smrt-video

中文文档
0.62.1发布于 2026/11/17MITTypeScriptES Module近 30 天下载 1.5万

SMRT生态系统人工智能视频制作的视频内容管理

中文使用文档
文档目录8 节
  1. 安装
  2. 使用量
  3. API 密码
  4. 模型
  5. 密钥类型
  6. 设计原则
  7. 资产所有权
  8. 依赖关系

@happyvertical/smrt-video (欢快的垂直)

S-m-r-t生态系统中AI动力视频生成的视频制作管道. 模型人物,表演者,场景,镜头,序列,组成,以及ComfyUI工作流程模板.

安装

pnpm add @happyvertical/smrt-video

使用量

import {
  Character,
  Performer,
  Scene,
  VideoShot,
  VideoSequence,
  VideoComposition,
  VideoShotCharacter,
  VideoWorkflow,
} from '@happyvertical/smrt-video';
import { Asset } from '@happyvertical/smrt-assets';

// Character = role being played (outfit, voice, branding)
const anchor = new Character({
  name: 'Bentley News Anchor',
  voiceProfileId: 'voice-123',
});
await anchor.save();

const seedImage = new Asset({
  name: 'Anchor Seed',
  sourceUri: 'file:///tmp/anchor-seed.png',
  mimeType: 'image/png',
});
await seedImage.save();
await anchor.addAsset(seedImage, 'seed-image');

// Performer = physical likeness for IP-Adapter face consistency
const performer = new Performer({ name: 'Alex', ipAdapterWeight: 0.85 });

// Scene = virtual background (image, video, or 360 panorama)
const studio = new Scene({
  name: 'News Studio',
  sourceType: 'image',
  projection: 'flat',
});

// Hierarchy: Composition -> Sequence -> Shot -> ShotCharacter
const composition = new VideoComposition({
  title: 'Evening News - March 2, 2026',
  fps: 30,
  width: 1920,
  height: 1080,
});
await composition.save();

const shot = new VideoShot({
  scriptText: 'Welcome to the evening news broadcast.',
  targetDuration: 30,
});
await shot.save();
// Estimated speech duration: scriptWordCount / 2.7 words per second
shot.estimatedDuration; // ~2.2 seconds
await shot.addAsset(seedImage, 'thumbnail');

// ComfyUI workflow with dynamic parameter injection
const workflow = new VideoWorkflow({
  name: 'Wan 2.6 + EchoMimic',
  workflowType: 'broadcast',
  workflowJson: comfyuiApiJson,
  nodeMapping: { seedImage: '1', audioFile: '5', outputVideo: '12' },
  requiredModels: ['wan_2.6_t2v_14b_fp8', 'echomimic_v2'],
});
await workflow.save();

// Inject runtime parameters into a deep-cloned workflow
const injected = workflow.injectParameters({
  seedImage: '/path/to/anchor.png',
  audioFile: '/path/to/tts.wav',
});

API 密码

模型

导出说明
Character虚拟人物a:种子图像+语音简介+品牌工具包
PerformerIP- Adapter FaceID 一致性的物理相似性
Scene有观点、照明和锚点的虚拟背景
VideoShot具有脚本和帧长度的原子生成单元(扩展内容)
VideoShotCharacter接合器:有作用的相机(一级/二级/背景)
VideoSequence主题部分( 扩展内容) 有过渡类型和顺序
VideoComposition顶级容器( 扩展内容): fps, 分辨率, 渲染状态
VideoWorkflowComfyUI 模板, 用于输入参数的节点映射
CompositeJob跟踪多步视频生成任务

收藏: CharacterCollection, (中文(简体) ), VideoCompositionCollection, (中文(简体) ), VideoSequenceCollection, (中文(简体) ), VideoShotCollection, (中文(简体) ), VideoShotCharacterCollection。 。 。 .

加农资产加入:

  • CharacterOwnedAsset - > (中文) character_assets
  • PerformerOwnedAsset - > (中文) performer_assets
  • SceneOwnedAsset - > (中文) scene_assets
  • VideoShot, (中文(简体) ), VideoSequence,以及 VideoComposition 继承 Content 资产助手 content_assets

科技和创新遗产资产分类 CharacterAsset, (中文(简体) ), PerformerAsset, (中文(简体) ), SceneAsset, (中文(简体) ), VideoCompositionAsset, (中文(简体) ), VideoSequenceAsset,以及 VideoShotAsset 迁移时仍可读取,但新作应该通过模型帮助. 提供新的合并表格 smrt db:migrate 之前依赖犬科写作。 当新表格尚未出现时,读取仍然会回到遗留字段/科学、技术和创新行.

密钥类型

导出说明
CharacterStatuspending, (中文(简体) ), ready
BrandingConfig标记、 颜色、 字体、 下端、 滴答设置
WorkflowTypeprebake, (中文(简体) ), broadcast, (中文(简体) ), lipsync, (中文(简体) ), postprod, (中文(简体) ), custom
NodeMapping将语义名称(种子图像、音频文件等)映射到ComfyUI节点ID
RenderStatusdraft, (中文(简体) ), rendering, (中文(简体) ), ready, (中文(简体) ), failed
VideoShotStatusdraft, (中文(简体) ), queued, (中文(简体) ), processing, (中文(简体) ), ready, (中文(简体) ), failed, (中文(简体) ), published
TransitionTypenone, (中文(简体) ), fade, (中文(简体) ), slide, (中文(简体) ), wipe
VideoMetadata持续时间, 分辨率, 编码器, fps, 单词计时
SceneSourceTypeimage, (中文(简体) ), video, (中文(简体) ), panorama_360, (中文(简体) ), panorama_180
VideoShotCharacterRoleprimary, (中文(简体) ), secondary, (中文(简体) ), background

设计原则

存储相框,计算秒。 所有使用期间 durationInFrames; 转换为 frames / fps发言时间估计为2.7个字/秒(+/-15%容忍度).

资产所有权

Character, (中文(简体) ), Performer,以及 Scene 曝光 getAssets(), (中文(简体) ), getAssetByRole(), (中文(简体) ), addAsset(),以及 removeAsset() {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}在冠名词表上 在移徙期间,他们继续阅读遗留的斯卡尔槽和遗留的科学、技术和创新资产行.

VideoShot, (中文(简体) ), VideoSequence,以及 VideoComposition 继承同一助手 Content,所以他们的犬类所有权表是 content_assets 而不是一个视频专用的加入表.

依赖关系

  • @happyvertical/smrt-core -- ORM 和代码生成
  • @happyvertical/smrt-assets - 基础资产管理
  • @happyvertical/smrt-config -- 配置装入
  • @happyvertical/smrt-content -- 内容模型(视频/序列/组合扩展内容)
  • @happyvertical/smrt-profiles -- 字符配置参考
  • @happyvertical/smrt-tenancy -- 多租户范围界定
  • @happyvertical/smrt-voice -- 语音简介参考文献

版本与发布记录

@happyvertical/smrt-video 共发布 365 个版本,首次发布于 2026/06/23;过去 12 个月发布了 365 个版本。

版本发布日期距今
0.62.1latest2026/11/17今天
0.62.02026/11/17今天
0.61.62026/11/161 天前
0.61.52026/11/161 天前
0.61.42026/11/161 天前
0.61.32026/11/152 天前

关于 @happyvertical/smrt-video 的常见问题

@happyvertical/smrt-video 是什么?

SMRT生态系统人工智能视频制作的视频内容管理

如何安装 @happyvertical/smrt-video?

在项目目录运行 npm install @happyvertical/smrt-video,或使用 pnpm add / yarn add / bun add。

@happyvertical/smrt-video 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@happyvertical/smrt-video 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@happyvertical/smrt-video 可以商用吗?

@happyvertical/smrt-video 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@happyvertical/smrt-video 的下载量有多少?

根据 npm 官方下载统计,@happyvertical/smrt-video 在 2026/10/17 – 2026/11/15 这 30 天内被下载 15,398 次,日均约 513 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@happyvertical/smrt-video 还在维护吗?

最新版本 0.62.1 发布于 2026/11/17(今天);至今共发布 365 个版本,其中过去 12 个月发布了 365 个;首次发布于 2026/06/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。