generate_video
Animate an input image into a video using a text prompt. Control duration, size, and motion intensity for custom results.
Instructions
Generate a video using WaveSpeed AI.
Args:
image (str): Required. URL, base64 string, or local file path of the input image to animate.
prompt (str): Required. Text description of the video to generate. MUST BE IN ENGLISH. Non-English prompts will be rejected or result in poor quality outputs.
model (str, optional): Model to use for video generation.
negative_prompt (str, optional): Text description of what to avoid in the video. Default: "".
loras (list, optional): List of LoRA models to use, each with a path and scale. Format: [{"path": "model_path", "scale": weight_value}]. Default: [].
size (str, optional): Size of the output video in format "width*height". Default: "832*480".
num_inference_steps (int, optional): Number of denoising steps. Higher values improve quality but increase generation time. Default: 30.
duration (int, optional): Duration of the video in seconds. Must be either 5 or 10. Default: 5.
guidance_scale (float, optional): Guidance scale for text adherence. Controls how closely the video matches the text description. Default: 5.
flow_shift (int, optional): Shift of the flow in the video. Affects motion intensity. Default: 3.
seed (int, optional): Random seed for reproducible results. Set to -1 for random. Default: -1.
enable_safety_checker (bool, optional): Whether to enable safety filtering. Default: True.
output_directory (str, optional): Directory to save the generated video. Uses a temporary directory if not provided.
request_id (str, optional): Request correlation ID for tracing the entire request chain. Strongly recommended to provide a unique ID (e.g., UUID) to correlate logs across the request lifecycle.
Returns:
WaveSpeedResult object with the result of the video generation, containing:
- status: "success" or "error"
- urls: List of video URLs if successful
- base64: List of base64 encoded videos if resource_mode is set to base64
- local_files: List of local file paths if resource_mode is set to local
- error: Error message if status is "error"
- processing_time: Time taken to generate the video(s)
Examples:
Basic usage: generate_video(image="https://example.com/image.jpg", prompt="The dog running through a forest")
Advanced usage: generate_video(
image="/path/to/local/image.jpg",
prompt="The dog running through a forest",
duration=10,
negative_prompt="blurry, low quality"
)
Note:
IMPORTANT: Prompts MUST be in English. The system only processes English prompts properly.
Non-English prompts will be rejected or produce low-quality results. If user input is not in English,
you MUST translate it to English before passing to this tool.Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| image | Yes | ||
| prompt | Yes | ||
| model | No | ||
| negative_prompt | No | ||
| loras | No | ||
| size | No | 832*480 | |
| num_inference_steps | No | ||
| duration | No | ||
| guidance_scale | No | ||
| flow_shift | No | ||
| seed | No | ||
| enable_safety_checker | No | ||
| output_directory | No | ||
| request_id | No |