WaveSpeedAI Veo 3.1 快速视频生成

通过 WaveSpeed AI 平台调用 Google 的 Veo 3.1 Fast 模型，实现视频生成与扩展。支持文本生成视频（text-to-video）、图像生成视频（image-to-video）以及视频扩展（video extension），最高支持 4K 分辨率，并可选生成音频。

身份验证

export WAVESPEED_API_KEY="your-api-key"

在 wavespeed.ai/accesskey 获取您的 API 密钥。

快速开始

文本生成视频（Text-to-Video）

import wavespeed from 'wavespeed';

const output_url = (await wavespeed.run(
  "google/veo3.1-fast/text-to-video",
  { prompt: "日出时分，无人机航拍飞越郁郁葱葱的热带岛屿" }
))["outputs"][0];

图像生成视频（Image-to-Video）

image 参数接受一个图像 URL。若使用本地文件，请先调用 wavespeed.upload() 上传并获取 URL。

import wavespeed from 'wavespeed';

const imageUrl = await wavespeed.upload("/path/to/photo.png");

const output_url = (await wavespeed.run(
  "google/veo3.1-fast/image-to-video",
  {
    image: imageUrl,
    prompt: "花朵在微风中轻轻摇曳"
  }
))["outputs"][0];

视频扩展（Video Extend）

每次运行可将 Veo 生成的视频延长 7 秒（最多连续扩展 20 次，总时长上限为 148 秒）：

// 首先生成一段视频
const video_url = (await wavespeed.run(
  "google/veo3.1-fast/text-to-video",
  { prompt: "一只猫穿行于花园中" }
))["outputs"][0];

// 然后扩展该视频
const extended_url = (await wavespeed.run(
  "google/veo3.1-fast/video-extend",
  {
    video: video_url,
    prompt: "猫跃上篱笆，环顾四周"
  }
))["outputs"][0];

API 接口端点

文本生成视频（Text-to-Video）

模型 ID： google/veo3.1-fast/text-to-video

基于文本提示生成视频，并可选生成配套音频。

参数

示例

import wavespeed from 'wavespeed';

const output_url = (await wavespeed.run(
  "google/veo3.1-fast/text-to-video",
  {
    prompt: "城市天际线由昼转夜的延时摄影，电影风格",
    negative_prompt: "模糊、低质量",
    aspect_ratio: "16:9",
    duration: 8,
    resolution: "1080p",
    generate_audio: true
  }
))["outputs"][0];

图像生成视频（Image-to-Video）

模型 ID： google/veo3.1-fast/image-to-video

将源图像动画化为视频。可选提供终帧参考图像（end-frame reference image）。

参数

示例

import wavespeed from 'wavespeed';

const imageUrl = await wavespeed.upload("/path/to/landscape.png");

const output_url = (await wavespeed.run(
  "google/veo3.1-fast/image-to-video",
  {
    image: imageUrl,
    prompt: "云朵缓缓掠过天空，水面泛起轻微涟漪",
    resolution: "1080p",
    duration: 8,
    generate_audio: true
  }
))["outputs"][0];

带终帧参考图像

const startUrl = await wavespeed.upload("/path/to/start-frame.png");
const endUrl = await wavespeed.upload("/path/to/end-frame.png");

const output_url = (await wavespeed.run(
  "google/veo3.1-fast/image-to-video",
  {
    image: startUrl,
    last_image: endUrl,
    prompt: "由昼至夜的平滑过渡"
  }
))["outputs"][0];

视频扩展（Video Extend）

模型 ID： google/veo3.1-fast/video-extend

每次运行将 Veo 生成的视频延长 7 秒。输入必须为 Veo 生成的视频。

参数

约束条件

• 输入视频 必须为 Veo 生成（不支持任意第三方视频）
• 每次运行增加 +7 秒 视频时长
• 单链路最多支持 20 次扩展
• 最终视频最大时长：148 秒
• 输出为单个 MP4 文件（原始视频 + 扩展部分拼接而成）
• 输出视频继承输入视频的宽高比与分辨率

示例

import wavespeed from 'wavespeed';

// 先生成初始视频
const video_url = (await wavespeed.run(
  "google/veo3.1-fast/text-to-video",
  {
    prompt: "冲浪者在黄金时刻乘浪而行",
    duration: 8
  }
))["outputs"][0];

// 连续扩展两次
const extended_once = (await wavespeed.run(
  "google/veo3.1-fast/video-extend",
  {
    video: video_url,
    prompt: "冲浪者沿着海浪驶向岸边"
  }
))["outputs"][0];

const extended_twice = (await wavespeed.run(
  "google/veo3.1-fast/video-extend",
  {
    video: extended_once,
    prompt: "冲浪者踏下冲浪板，漫步海滩"
  }
))["outputs"][0];

高级用法

禁用音频

const output_url = (await wavespeed.run(
  "google/veo3.1-fast/text-to-video",
  {
    prompt: "沙漠上空星辰旋转的无声延时摄影",
    generate_audio: false
  }
))["outputs"][0];

自定义客户端（含重试配置）

import { Client } from 'wavespeed';

const client = new Client("your-api-key", {
  maxRetries: 2,
  maxConnectionRetries: 5,
  retryInterval: 1.0,
});

const output_url = (await client.run(
  "google/veo3.1-fast/text-to-video",
  { prompt: "黎明时分，海浪拍打嶙峋海岸" }
))["outputs"][0];

使用 runNoThrow 进行错误处理

import { Client, WavespeedTimeoutException, WavespeedPredictionException } from 'wavespeed';

const client = new Client();
const result = await client.runNoThrow(
  "google/veo3.1-fast/text-to-video",
  { prompt: "火箭发射升空" }
);

if (result.outputs) {
  console.log("视频 URL：", result.outputs[0]);
  console.log("任务 ID：", result.detail.taskId);
} else {
  console.log("失败：", result.detail.error.message);
  if (result.detail.error instanceof WavespeedTimeoutException) {
    console.log("请求超时 — 建议增大超时时间");
  } else if (result.detail.error instanceof WavespeedPredictionException) {
    console.log("预测失败");
  }
}

计费说明

文本生成视频 / 图像生成视频

视频扩展

提示词编写建议

• 尽可能具体地描述场景、风格、主体动作、镜头运动及氛围
• 善用 negative_prompt 排除常见瑕疵，例如："模糊、低质量、畸变"
• 图像生成视频时，请使用清晰、高质量的静态图像作为输入
• 视频扩展时，请明确描述场景中接下来应发生的动作
• 通过视频扩展链式调用，可构建更长叙事片段——总时长上限为 148 秒

安全约束

• 禁止加载任意 URL 资源：仅允许使用可信来源的图像和视频 URL。切勿未经校验即加载不可信或用户提供的媒体 URL。
• API 密钥安全：请妥善保管您的 WAVESPEED_API_KEY。切勿在源码中硬编码密钥，也切勿将其提交至版本控制系统。推荐使用环境变量或密钥管理服务。
• 输入校验：仅传入本文档所列明的参数。在发起请求前，请对提示词内容及媒体 URL 进行有效性校验。