Agnes 视频生成

解决什么问题

视频生成模型通常涉及异步任务、参数对齐和公网资源约束，开发者需要手动处理任务创建、轮询、错误重试和参数校验。本技能将 Agnes Video V2.0 的调用流程封装为标准化接口，减少重复逻辑。

核心能力与工作流

• 文生视频：通过 prompt 直接生成 3-18 秒视频，默认 121 帧（约 5 秒）
• 图生视频：输入单张公网图片 URL + 动作描述，生成动态效果
• 关键帧动画：通过两张关键帧图生成平滑过渡视频，保持主体一致性

调用 generate_video() 时，技能会自动完成：

1. 模式识别（根据是否传入 image 或 keyframes）
2. 时长映射（默认 121 帧，支持 81/241/441 对齐）
3. 画幅适配（默认 1152x768，可切换 720p/1080p 三档分辨率）
4. 异步轮询（通过 video_id 查询结果，间隔 10 秒，最长等待 10 分钟）

关键约束与边界

• num_frames 必须满足 8n+1（如 81、121、241、441），否则会被 API 拒绝
• 图生视频和关键帧模式的 image 必须为公网可访问 URL（不支持本地路径或 file:// 协议）
• 超过 18 秒的视频需分段生成后拼接，当前模型不支持直接输出
• 未配置 AGNES_API_KEY 环境变量时，脚本会明确报错并提示获取方式

适用场景

• 需要快速集成视频生成能力到现有系统
• 处理用户主动提供参考图或关键帧的创意场景
• 对视频时长、画幅有明确技术约束的工程化需求

注意点

• 提示词建议采用「主体+动作+场景+镜头运动+光线+风格」结构，英文效果更稳定
• 关键帧模式需确保两张图片的主体一致，否则过渡效果可能异常
• 轮询超时后保留 video_id，支持后续手动查询，避免任务丢失