SuperAPI AI 工具集

veo3-1

编程与开发

查看项目

更新于 10-15 20:35

技能介绍

用途:通过 grsai.com API 调用 Google Veo 3.1 生成视频,适用于文生视频及各类动态内容创作请求。

主要能力:提供多种模型档位,包括 veo3.1-fast(默认,720p,成本最低)、veo3.1-fast-1080p、veo3.1-fast-4k、veo3.1-pro(720p)、veo3.1-pro-1080p、veo3.1-pro-4k。时长可选 4、6、8 秒,画幅比例支持 16:9(默认横屏)与 9:16(竖屏/移动端)。

使用方式:在用户当前工作目录运行(不要 cd 进技能目录): uv run scripts/generate_video.py --prompt "description" --filename "output.mp4" [--model MODEL] [--duration 4|6|8] [--aspect-ratio 16:9|9:16] [--api-key KEY] 加 --url-only 可跳过下载、仅打印视频 URL,便于与其他工具串联。推荐先草稿后定稿:草稿用 --model veo3.1-fast --duration 4,定稿用 --model veo3.1-pro-4k --duration 8。API Key 可通过 --api-key 传入或设置 GRSAI_API_KEY 环境变量。生成后始终单独一行打印 VIDEO_URL: <full_url>;不加 --url-only 时保存文件并打印 Video saved: <path>。

适用场景:需要快速迭代提示词的视频草稿、最终高质量视频输出,以及将视频 URL 传给反馈类技能做质量评估。

限制:生成失败可能因内容审核或输入无效,需改写提示词;HTTP 401 表示密钥错误或过期;超时可改用更快模型或更短时长;瞬时错误(HTTP 429、网络超时)30 秒后重试一次,最多两次,否则应向用户反馈。若提示 uv: command not found,可安装:curl -LsSf https://astral.sh/uv/install.sh | sh,然后重启终端。文件命名建议采用 yyyy-mm-dd-hh-mm-ss-descriptive-name.mp4 格式。