Generate images from text using Agnes AI.

Supports two models:

• agnes-image-2.0-flash: Standard quality

• agnes-image-2.1-flash: Enhanced quality (recommended)

Args: prompt: Text description of the image to generate. model: Model name (agnes-image-2.0-flash or agnes-image-2.1-flash). size: Output size (e.g. 1024x768, 1024x1024, 768x1024). n: Number of images to generate (1-4). Default: 1. images: Optional list of reference image URLs for multi-image composition. output_dir: Directory to save the downloaded image(s). Defaults to ~/agnes_output. return_mode: 'url' for image URL, 'b64' for base64 + local save.

Returns: dict with url, local_path, model, size, n, images.

Generate new image(s) based on reference image(s) and a text prompt.

This is image-to-image generation: provide one or more reference images (as URLs) along with a text prompt describing the desired output.

Args: prompt: Text description guiding the generation. images: List of reference image URLs (at least one required). model: Model name (agnes-image-2.0-flash or agnes-image-2.1-flash). size: Output size (e.g. 1024x768, 1024x1024, 768x1024). n: Number of images to generate (1-4). Default: 1. output_dir: Directory to save the downloaded image(s). Defaults to ~/agnes_output. return_mode: 'url' for image URL, 'b64' for base64 + local save.

Returns: dict with url, local_path, model, size, n, images.

Generate a video from text (and optional image(s)) using Agnes AI.

This is an async operation that polls until completion (may take several minutes).

Args: prompt: Text description of the video content. model: Model name. Default: agnes-video-v2.0 width: Video width. Default: 1152 height: Video height. Default: 768 num_frames: Total frames (8n+1 rule, max 441). Common values: 81(~3s), 121(~5s), 241(~10s), 441(~18s) frame_rate: FPS, 1-60. Default: 24 image: Optional single image URL for image-to-video. images: Optional list of image URLs for multi-image video / keyframe animation. When provided, 'image' is ignored. negative_prompt: Optional negative prompt to exclude from generation. seed: Optional random seed (-1 for random). mode: Generation mode (e.g. 'ti2vid', 'keyframes'). Optional. num_inference_steps: Number of inference steps. Optional. output_dir: Directory to save the downloaded video. Defaults to ~/agnes_output.

Returns: dict with video_id, status, video_url, local_path, seconds, size.

Animate a static image into a video using Agnes AI.

Provide a single image URL (or Data URI base64) and a text prompt describing the desired motion/animation.

This is an async operation that polls until completion (may take several minutes).

Args: prompt: Text description of the desired motion/animation. image: Input image URL or Data URI base64 (required). model: Model name. Default: agnes-video-v2.0 width: Video width. Default: 1152 height: Video height. Default: 768 num_frames: Total frames (8n+1 rule, max 441). Common values: 81(~3s), 121(~5s), 241(~10s), 441(~18s) frame_rate: FPS, 1-60. Default: 24 negative_prompt: Optional negative prompt to exclude from generation. seed: Optional random seed (-1 for random). num_inference_steps: Number of inference steps. Optional. output_dir: Directory to save the downloaded video. Defaults to ~/agnes_output.

Returns: dict with video_id, status, video_url, local_path, seconds, size.

Generate a smooth video transitioning between multiple keyframe images.

Provide 2+ image URLs as keyframes. The model generates a video that smoothly transitions between them, guided by the text prompt.

This is an async operation that polls until completion (may take several minutes).

Args: prompt: Text description guiding the animation and transitions. images: List of keyframe image URLs (at least 2 recommended). model: Model name. Default: agnes-video-v2.0 width: Video width. Default: 1152 height: Video height. Default: 768 num_frames: Total frames (8n+1 rule, max 441). Common values: 81(~3s), 121(~5s), 241(~10s), 441(~18s) frame_rate: FPS, 1-60. Default: 24 negative_prompt: Optional negative prompt to exclude from generation. seed: Optional random seed (-1 for random). num_inference_steps: Number of inference steps. Optional. output_dir: Directory to save the downloaded video. Defaults to ~/agnes_output.

Returns: dict with video_id, status, video_url, local_path, seconds, size.

Check the status of a video generation task.

Args: video_id: The video_id returned from text_to_video. task_id: The task_id returned from text_to_video (alternative).

Returns: dict with task_id, video_id, status, progress, video_url, seconds, size, error.