Metadata-Version: 2.1
Name: gemini-omni-client
Version: 1.0.0
Summary: Official Python SDK for Gemini Omni multimodal AI video generator and conversational video editor.
Home-page: https://gemini-omni.dev
Author: Gemini Omni
Author-email: support@gemini-omni.dev
License: UNKNOWN
Project-URL: Homepage, https://gemini-omni.dev
Project-URL: Documentation, https://gemini-omni.dev/gemini-omni-1-1-flash
Project-URL: Interactive Studio, https://gemini-omni.dev/#generator
Project-URL: Prompt Library, https://gemini-omni.dev/prompts
Project-URL: Repository, https://github.com/lidong-tools/website-gemini-omni-dev
Project-URL: Bug Tracker, https://github.com/lidong-tools/website-gemini-omni-dev/issues
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Multimedia :: Video
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# Gemini Omni Python SDK

[![PyPI version](https://img.shields.io/pypi/v/gemini-omni-client.svg)](https://pypi.org/project/gemini-omni-client/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python Versions](https://img.shields.io/pypi/pyversions/gemini-omni-client.svg)](https://pypi.org/project/gemini-omni-client/)
[![Official Website](https://img.shields.io/badge/Official%20Studio-gemini--omni.dev-blue)](https://gemini-omni.dev)

Official Python SDK for **[Gemini Omni](https://gemini-omni.dev)** — the next-generation unified multimodal AI video generation and conversational video editing platform.

> 🎬 **Online Studio & Generator**: Experience the full web interface at **[https://gemini-omni.dev](https://gemini-omni.dev)**.

---

## ✨ Features

- **Text-to-Video & Image-to-Video**: Native support for multimodal video prompts.
- **Cinematic Quality**: 720p, 1080p, and 4K output formats with selectable aspect ratios (`16:9`, `9:16`, `1:1`).
- **Character Consistency**: Preserve subject identity and style using reference images.
- **Zero Dependencies**: Lightweight SDK using pure Python standard libraries.
- **Full Type Hinting**: Comprehensive typing support for IDE autocomplete.

---

## 📦 Installation

```bash
pip install gemini-omni-client
```

---

## 🚀 Quick Start

### 1. Generate Video from Text Prompt

```python
from gemini_omni import GeminiOmniClient

client = GeminiOmniClient()

# Submit a cinematic video generation task
task = client.generate_video(
    prompt="Cinematic tracking shot of a futuristic neon cyber-city at dusk, high-definition reflections in rainwater, 4K resolution",
    aspect_ratio="16:9",
    resolution="1080p",
)

print(f"Task successfully submitted! Task ID: {task.get('taskId')}")
```

### 2. Check Generation Status

```python
task_status = client.get_task(task_id="YOUR_TASK_ID")
print("Status:", task_status.get("status"))
if task_status.get("videoUrl"):
    print("Video Output URL:", task_status.get("videoUrl"))
```

---

## 🔗 Official Links & Resources

- **Official Web Platform**: [https://gemini-omni.dev](https://gemini-omni.dev)
- **Prompt Library**: [https://gemini-omni.dev/prompts](https://gemini-omni.dev/prompts)
- **Model Specs & Benchmark**: [https://gemini-omni.dev/gemini-omni-1-1-flash](https://gemini-omni.dev/gemini-omni-1-1-flash)
- **Source Code & Issues**: [https://github.com/lidong-tools/website-gemini-omni-dev](https://github.com/lidong-tools/website-gemini-omni-dev)

---

## 📄 License

MIT © [Gemini Omni](https://gemini-omni.dev)


