Agent Skills
返回列表
🎨

Venice视频生成

设计多媒体 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/venice-video-lr-2zna。

技能介绍

解决的核心问题

异步视频处理常面临任务提交与结果获取脱节的问题:传统同步API需持续占用连接等待生成完成,而视频渲染耗时远超常规HTTP超时限制。Venice视频通过类音频的异步架构,将任务拆分为提交、轮询、回调三阶段,避免长连接阻塞,同时兼容高延迟场景(如跨区域渲染集群)。

技能工作原理

技能封装了五个REST端点形成完整工作流:

  • POST /tasks 提交视频生成任务,返回唯一任务ID与预估耗时
  • GET /tasks/{id} 轮询任务状态,支持pending/processing/completed三态切换
  • POST /callbacks 注册事件钩子,支持completion/failure两种通知类型
  • GET /assets/{id} 获取生成结果的CDN链接(默认有效期24小时)
  • DELETE /tasks/{id} 主动取消未完成任务并释放资源

关键能力在于状态机设计:当任务进入processing状态后,技能自动切换为低频轮询模式(默认10秒间隔),避免高频请求触发限流。回调机制支持Webhook与轮询双模式,开发者可根据网络环境灵活选择。

适用边界与注意点

该技能适合处理分钟级视频生成任务(如短视频片段、动态可视化),但不适合实时流式传输场景。需注意:

  • 单个任务最大支持4K分辨率/60秒时长
  • 并发任务数受账户等级限制(免费版限3个并行)
  • 回调地址需配置HTTPS且响应时间需<2秒
  • 结果文件存储采用临时凭证,需及时转存至持久化存储

使用场景

  • 内容团队在生成短片素材后,需异步等待渲染结果并获取可下载链接。
  • 后端服务要批量提交视频任务,并通过轮询查询处理进度。
  • 平台需要监听视频生成完成事件,以便自动触发下游通知或审核。
  • 开发者在调用视频接口时,需要主动取消未完成任务以节省资源。

适合人员

  • 负责媒体流水线的后端工程师,需要设计异步视频任务与轮询逻辑。
  • 构建内容平台的开发者,需要集成视频生成回调与结果下载。
  • 维护渲染集群的运维工程师,需要监控视频任务状态并处理异常。
  • 实现自动化工作流的工程师,需要基于事件钩子触发后续业务动作。