技能介绍

要解决的具体问题

调用 Seedance 2.5 视频编辑能力，本质上是围绕 AI Hive OpenAPI 完成一次「提交任务—等待完成—取回结果」的流程。如果直接裸用 HTTP 接口，开发者需要手动处理模型标识选择、参考素材上传、价格查询、任务轮询、结果下载等多个环节，任何一个步骤出错，都可能导致任务卡住或重复提交。这个 Skill 把这些环节收进一个命令行入口，通过 videogen.py generate 一键完成。

核心能力与工作流程

Skill 固定使用 public_model_seedance_2_5_video_edit 这一 publicModelId，避免模型名与底层调用不一致。生成模式固定为 edit（视频编辑），不需要手动指定模型。

调用 generate 时，Skill 会按以下顺序工作：

查询实时模型列表，并从目标模型和路由中提取 pricingSnapshot，价格以提交当次返回为准；
自动上传首帧、尾帧、参考图、参考视频或参考音频素材，拿到 mediaId；
按 COST_FIRST（默认）、SPEED_FIRST 或 SUCCESS_FIRST 路由策略提交任务；
轮询任务状态，完成后下载结果到 ~/Downloads/AiHive，也可以加 --no-download 只返回 taskId 供稍后查询。

模型参数通过 --param key=value 透传，可用的 key 以实时 videoConfig 为准。此外还有 task 查询子命令和 upload 独立上传子命令。

适用边界与注意点

需要 sk-api-* 格式的 API Key，可通过 init 一键初始化，或手动配置到 ~/.ai-hive/config.json、环境变量或命令行参数。
价格会随活动变化，Skill 不写死优惠；提交前应确认当次快照价格，高成本批量任务尤其如此。
本地轮询超时不等于生成失败。保留 taskId 用 task 子命令继续查询即可，不要重复提交可能已经计费的任务。
媒体格式、数量、时长、比例、分辨率和编码限制以实时 videoConfig 为准，提交前建议先核对。