docstring

app.py

@@ -147,6 +147,28 @@ def generate(prompt, negative_prompt, input_image_filepath, input_video_filepath
              ui_frames_to_use,
              seed_ui, randomize_seed, ui_guidance_scale, improve_texture_flag,
              progress=gr.Progress(track_tqdm=True)):
+    """
+    Generate high-quality videos using LTX Video model with support for text-to-video, image-to-video, and video-to-video modes.
+
+    Args:
+        prompt (str): Text description of the desired video content.
+        negative_prompt (str): Text describing what to avoid in the generated video.
+        input_image_filepath (str): Path to input image file for image-to-video mode, or None for other modes.
+        input_video_filepath (str): Path to input video file for video-to-video mode, or None for other modes.
+        height_ui (int): Height of the output video in pixels, must be divisible by 32.
+        width_ui (int): Width of the output video in pixels, must be divisible by 32.
+        mode (str): Generation mode - one of "text-to-video", "image-to-video", or "video-to-video".
+        duration_ui (float): Duration of the output video in seconds (0.3 to 8.5).
+        ui_frames_to_use (int): Number of frames to use from input video for video-to-video mode.
+        seed_ui (int): Random seed for reproducible generation (0 to 2^32-1).
+        randomize_seed (bool): Whether to use a random seed instead of the specified seed.
+        ui_guidance_scale (float): CFG scale controlling prompt influence (1.0 to 10.0).
+        improve_texture_flag (bool): Whether to use multi-scale generation for better texture quality.
+        progress (gr.Progress): Progress tracker for the generation process.
+
+    Returns:
+        tuple: A tuple containing (output_video_path, used_seed) where output_video_path is the path to the generated video file and used_seed is the actual seed used for generation.
+    """
 
     if randomize_seed:
         seed_ui = random.randint(0, 2**32 - 1)