用途:本技能指导使用 z-ai-web-dev-sdk 构建 AI 视频生成功能,让模型根据文本描述或图像生成视频,适用于需要批量、可编程视频生成的开发场景。
主要能力:支持文本生成视频、单图生成视频、首尾帧(关键帧)生成视频,以及通过 --with-audio 生成 AI 音频效果。可配置参数包括:质量模式 speed 或 quality(默认 speed)、分辨率(如 1920x1080、1024x1024、768x1344、864x1152、1344x768、1152x864、1440x720、720x1440 等)、帧率 30 或 60(默认 30)、时长 5 或 10 秒(默认 5)、模型名。支持将结果输出为 JSON 文件。
使用方式:可用 CLI 执行简单任务,例如 z-ai video --prompt "A cat playing with a ball" --poll;也支持短选项形式。自定义示例:z-ai video -p "City timelapse" --size "1920x1080" --fps 60 --poll;时长示例:z-ai video -p "Fireworks display" --duration 10 --poll;带音频:z-ai video -p "Thunder storm approaching" --with-audio --poll;保存结果:z-ai video -p "Sunrise over mountains" --poll -o video_result.json;轮询参数:--poll-interval 10 --max-polls 30;仅创建任务:z-ai video -p "Abstract art animation" -o task.json;后续查询:z-ai async-result --id "task-id-here" --poll。
图像输入:image_url 参数支持 base64 编码数据与 URL,但强烈建议使用 base64,以避免网络问题或访问限制;必须使 data URI 中的 MIME 类型与实际图像格式(image/jpeg、image/png、image/webp 等)匹配。首尾帧模式下以逗号分隔两个图像值。SDK 用法上,通过 ZAI.create() 获取实例,调用 zai.video.generations.create({...}) 创建任务,再用 zai.async.result.query(task.id) 轮询状态。
工作流程:视频生成采用两步异步模式,先创建任务获得 task ID,再轮询结果直至完成并获取视频 URL。任务状态包括 PROCESSING、SUCCESS、FAIL。可从 result.video_result?.[0]?.url 或 result.video_url、result.url、result.video 等字段提取视频地址。参考脚本位于技能目录下的 scripts/video.ts。
适用场景:快速视频生成测试、一次性视频创建、命令行自动化脚本、批量生成并配合自定义任务队列、复杂工作流的生产应用集成。
限制:z-ai-web-dev-sdk 必须在后端代码中使用,禁止用于客户端代码。收费、价格、模型清单与生成效果等资料暂未提供。