Submit a Veo 3.1 video generation job. Returns immediately with a job_id.

Videos typically take 30-120 seconds. Call check_video(job_id) to poll for completion. The final MP4 is written to the configured OUTPUT_DIR and its absolute path is returned by check_video once ready.

Args: prompt: Text description of the video to generate. model: "lite" (cheapest), "fast" (default, good balance), or "standard" (highest quality, most expensive). See get_pricing for rates. aspect_ratio: "16:9" (landscape) or "9:16" (portrait). resolution: "720p", "1080p", or "4k". "4k" is rejected for model="lite". negative_prompt: Optional text describing what to avoid. image_path: Optional absolute path to a PNG/JPEG/WebP file to use as the starting frame for image-to-video generation.

Check a video generation job. Downloads the file when ready.

Returns one of three shapes:

• {"status": "pending", "elapsed_seconds": int}

• {"status": "complete", "path": str, "duration_seconds": float}

• {"status": "failed", "error": str}

Safe to call repeatedly. Once a job is complete or failed, subsequent calls return the cached terminal state without re-polling.

Args: job_id: The id returned by submit_video.

List every MP4 file in the configured OUTPUT_DIR, newest first.

Each entry has absolute path, size in bytes, and creation timestamp.

Generate an image synchronously. Blocks until the file is on disk.

Typical latency is under 10 seconds. The PNG is written to the configured OUTPUT_DIR and the absolute path is returned.

Args: prompt: Text description of the image to generate. model: "nano-banana" (Gemini 2.5 Flash Image, the default — cheapest and fastest) or "imagen" (Imagen 4, higher quality, higher cost). aspect_ratio: "1:1", "16:9", "9:16", "4:3", or "3:4". negative_prompt: Optional text describing what to avoid. Ignored by Nano Banana; used by Imagen 4 when supplied.

List every PNG file in the configured OUTPUT_DIR, newest first.

Each entry has absolute path, size in bytes, and creation timestamp.

Return current published Gemini API pricing for the models this server uses.

Rates are per-image for images and per-second for video. Pricing is hardcoded from the official docs (see the source field) and may drift; always verify before expensive operations.