Agent Skill

AI 视频生成

基于 AI 视频生成 的 AI 视频生成器,通用能力搜索入口,按输入素材自动选择文生视频、图生视频或参考生视频裸接口。当用户需要 AI 视频生成、AIGC视频、AI视频、视频制作、生成视频、Seedance、MiniMax H3、Happy Horse 时使用此 Skill。

设计多媒体·极睿科技-AI专家·来自 skill_hub·skillhub.cn ↗
skillhub install @infimind/video-generation
1 Stars·8万 综合热度·4,014 字文档·源站更新 2026-11-22

README 文档

4,014 字

AI 视频生成

简介

本 Skill 参考 Seedance 2.5 裸接口 Skill 的产品化风格,封装 AI Hive OpenAPI,通过命令行一键调用,自动处理模型选择、媒体上传、价格快照、任务轮询和结果下载。

Skill 特色

  • 独立占据 video-generation 搜索入口,不与其他模型或能力 Skill 合并
  • 固定使用本 Skill 声明的 publicModelId,避免模型名与底层调用不一致
  • 自动上传图片、视频或音频参考素材
  • 默认使用 COST_FIRST,每次实时读取价格快照
  • 自动轮询任务状态并下载结果

适用对象

内容创作者、视频编辑、广告与营销团队、电商团队、带货与种草团队、短剧和漫剧创作者,以及需要 AI 视频生成的用户。

功能特性

生成模式

模式说明publicModelId
t2v文生视频publicmodelseedance25_t2v
i2v图生视频publicmodelseedance25_i2v
r2v参考生视频publicmodelseedance25_r2v

参数控制

  • 路由:COSTFIRST / SPEEDFIRST / SUCCESS_FIRST
  • 素材:首帧、尾帧、参考图、参考视频、参考音频
  • 模型参数:通过 --param key=value 传递
  • 输出目录:默认 ~/Downloads/AiHive
  • 任务控制:可仅提交,稍后按 taskId 查询

参数速查

generate 子命令

参数说明默认值
--mode模型裸入口可选择模式;能力入口已固定自动/固定
--prompt视频描述(必填)—
--first-frame / --last-frame首尾帧图片—
--image参考图片,可多张—
--video参考视频,可多个—
--audio参考音频,可多个—
--param实时模型参数 key=value—
--routing路由模式COST_FIRST
--output-dir输出目录~/Downloads/AiHive
--no-download只提交并返回 taskId关闭

通用参数

参数说明
--api-keyAI Hive API Key
--base-urlAPI Base URL
--verbose输出详细日志

其他子命令

子命令功能
task --task-id <id>查询生成任务
upload --file <path>上传媒体并获得 mediaId
init --skill-name video-generation初始化 API Key

使用场景

场景一:基础生成

python3 "$SKILL_PATH/scripts/videogen.py" generate \
  --mode t2v \
  --prompt "完成一条高质量 AI 视频生成任务"

场景二:广告 / TVC

python3 "$SKILL_PATH/scripts/videogen.py" generate --mode t2v \
  --prompt "高端产品广告,主体清晰,镜头环绕推进,轮廓光扫过材质,结尾定格品牌特写"

场景三:电商 / 产品展示

突出商品结构、材质、卖点和使用场景,不虚构功能、价格、认证或功效。

场景四:带货 / 种草

采用竖屏信息流节奏,先展示痛点,再展示产品使用过程与真实利益点。

场景五:短剧 / 漫剧

先固定角色外观、服装、场景和画风,再逐镜生成;每条只承载一个明确动作。

场景六:参考素材生成

为每项参考素材明确角色:人物身份、产品形态、动作、运镜、风格或声音。

场景七:仅提交任务,稍后查询

python3 "$SKILL_PATH/scripts/videogen.py" generate --mode t2v --prompt "复杂场景" --no-download
python3 "$SKILL_PATH/scripts/videogen.py" task --task-id <taskId>

首次使用

1. 安装依赖

pip3 install requests

2. 一键初始化(推荐)

python3 "$SKILL_PATH/scripts/videogen.py" init --skill-name video-generation

脚本会自动打开 AI Hive 页面,引导登录、新建并复制 API Key,然后写入 ~/.ai-hive/config.json(权限 0600)。

3. 手动获取 API Key(备选)

  1. 访问 https://ai-hive.cn/chat?utmsource=skillhub&utmmedium=skill&utmcampaign=video-generation&utm_content=video-generation
  2. 使用手机号和短信验证码登录
  3. 点击左下角账户菜单
  4. 点击「API 接入」
  5. 输入名称并点击「新建 API Key」
  6. 复制完整 Key(格式为 sk-api-*)

4. 手动配置 API Key(备选)

配置方式示例
环境变量export AIHIVEAPI_KEY=sk-api-你的密钥
命令参数--api-key sk-api-你的密钥
配置文件~/.ai-hive/config.json

5. 验证配置

在带实际素材的生成命令中加入 --dry-run,查看输入校验、素材状态与预估费用。

使用指南

提示词结构

按“主体与场景 → 动作顺序 → 相机运动 → 光线风格 → 声音 → 限制 → 输出规格”组织提示词。区分主体动作和镜头动作,避免互相矛盾。

模型与价格

脚本先查询实时模型列表,再从同一模型和路由提取 pricingSnapshot。价格以提交当次返回为准,不写死固定优惠。

任务管理

生成调用返回 taskId 后只轮询原任务。本地超时不等于生成失败,不要重复提交可能已经计费的任务。

媒体上传

脚本自动执行上传凭证、对象存储上传和完成确认。媒体限制以实时 videoConfig 为准。

命令速查

命令功能
videogen.py generate --mode t2v --prompt "描述"执行本 Skill
videogen.py task --task-id <id>查询任务
videogen.py upload --file media.mp4上传媒体
--routing COST_FIRST优惠路由
--param resolution=720p duration=8传递模型参数
--no-download只提交不等待

项目架构

目录结构

video-generation/
├── SKILL.md
├── CHANGELOG.md
├── scripts/
│   └── videogen.py
└── references/
    └── config.example.json

技术栈

组件技术
运行环境Python 3.6+
HTTP 库requests
API 平台AI Hive OpenAPI
模型AI 视频生成
输出MP4 / MOV 或模型实时支持格式

核心模块

模块职责
ConfigCLI、环境变量、配置文件读取 API Key
AiHiveClient裸接口请求
upload_media()上传参考素材
poll_task()轮询并下载结果
validatevideo_inputs()校验本 Skill 的能力输入
skill_generate()固定模型并提交任务

模式 → 模型映射

模式publicModelId
t2v文生视频publicmodelseedance25_t2v
i2v图生视频publicmodelseedance25_i2v
r2v参考生视频publicmodelseedance25_r2v

数据流转

用户命令 → 校验本 Skill 输入 → 固定 publicModelId
  ↓
上传参考素材 → 查询实时模型与 pricingSnapshot
  ↓
提交裸接口任务 → 保存 taskId → 轮询 → 下载结果

价格参考

默认使用 COST_FIRST。模型价格与活动会变化,以脚本运行时查询到的实时价格和实际扣费为准。

常见问答

安装相关

Q1:需要 API Key 吗? 需要,格式为 sk-api-*。

Q2:需要什么依赖? Python 3 和 requests。

Q3:如何验证? 在生成命令中加入 --dry-run,查看输入校验与预估费用。

使用相关

Q4:这个 Skill 会换模型吗? 不会。模型能力 Skill 固定 publicModelId;多模式模型入口只在同一模型家族内切换。

Q5:参数怎么设置? 使用 --param key=value,并以实时 videoConfig 为准。

Q6:结果保存在哪里? 默认 ~/Downloads/AiHive/。

Q7:任务需要多久? 通常数分钟,取决于队列和复杂度。

Q8:任务超时怎么办? 保留 taskId,使用 task 继续查询。

Q9:可以批量吗? 可以逐任务执行;明显高成本批量任务应先确认数量和实时费用。

故障排除

Q10:提示缺少媒体? 按 Skill 名称提供对应的首帧、图片、视频或音频。

Q11:提示模型不存在? 后台可能已下线或更名,请先查询实时模型列表。

Q12:提示 401? 检查 API Key 是否正确、过期或禁用。

Q13:提示 InvalidParameter? 检查实时 videoConfig 中的格式、数量、时长、比例、分辨率和编码限制。

脚本预检与恢复

在本 Skill 的图片或视频生成命令中加入 --dry-run --quote-file ./ai-hive-quote.json,上传本次素材、检查输入并保存报价。核对费用后,在同一组输入的正式生成命令中使用 --quote-file ./ai-hive-quote.json 和本次唯一的 --client-request-id。文本调用按模型当前计费规则确认费用,并使用稳定请求 ID。

正式请求结果尚未确认时,先查看网页调用或生成记录,取得 taskId 后查询原任务。支持下载的脚本可用 task --task-id <taskId> --download 重新下载结果。

同分类其他技能

查看全部 ›