技能介绍

解决的具体问题

视频生成流程通常涉及模型选择、素材上传、任务轮询、结果下载等多个环节，手动操作不仅耗时，还容易因参数配置错误导致生成失败。Seedance 2.5 参考生视频将 AI Hive OpenAPI 封装为命令行工具，通过固定模型 ID（public_model_seedance_2_5_r2v）避免模型名不一致问题，自动处理素材上传、价格快照读取、任务轮询和结果下载，减少人工干预。

核心能力与关键步骤

素材管理：自动上传图片、视频或音频参考素材（支持首帧/尾帧、参考图/视频/音频），无需手动处理上传凭证和对象存储确认。
参数控制：通过 --param key=value 传递实时模型参数（如 resolution=720p duration=8），以 videoConfig 为准动态适配生成需求。
任务管理：提交任务后返回 taskId，可通过 task --task-id 查询状态，避免因本地超时重复提交已计费任务。
路由策略：默认使用 COST_FIRST 路由，每次调用读取实时价格快照，价格以提交当次返回为准。

适用边界与注意点

价格动态性：模型价格与活动可能变化，需以脚本运行时查询的实时价格和实际扣费为准，不写死固定优惠。
任务超时处理：本地超时不等于生成失败，需保留 taskId 并使用 task 命令继续查询，避免重复提交导致额外费用。
参数校验：媒体格式、数量、时长、比例等限制以实时 videoConfig 为准，如遇 InvalidParameter 错误需检查参数是否符合当前模型配置。
批量任务限制：虽支持逐任务执行，但高成本批量任务需提前确认数量和实时费用，避免意外支出。