RunAPI Gemini Omni SDK for audio, character, and video workflows in JavaScript, Python, Ruby, Go, Java, and PHP
Project description
Gemini Omni Python SDK for RunAPI
The Gemini Omni Python SDK is the language-specific package for Gemini Omni on RunAPI. Use this package for voice resources, character resources, and multimodal video generation workflows when your application needs request bodies, task status lookup, and consistent RunAPI errors in Python.
Install
pip install runapi-gemini-omni
Quick start
from runapi.gemini_omni import GeminiOmniClient
client = GeminiOmniClient() # reads RUNAPI_API_KEY, or pass api_key="sk-..."
# Reusable voice (returns immediately)
voice = client.create_audio.run(audio_id="kore", name="Narrator")
# Reusable character (returns immediately)
character = client.create_character.run(
descriptions="A friendly robot guide",
reference_image_url="https://cdn.runapi.ai/public/samples/reference-1.jpg",
)
# Text-to-video (create + poll until complete)
result = client.text_to_video.run(
model="gemini-omni-flash-preview",
prompt="A paper airplane glides through a sunlit studio.",
aspect_ratio="16:9",
output_resolution="720p",
)
print(result.videos[0].url)
create_audio and create_character are synchronous: run submits and returns the result directly. text_to_video is asynchronous: use create to submit and return quickly, get to fetch the latest task state, and run to create and poll until completion.
RunAPI-generated file URLs are temporary. Download and store generated images, videos, audio, or other files in your own durable storage within 7 days; do not treat returned URLs as long-term assets.
Language notes
Pass parameters as keyword arguments and catch the runapi.gemini_omni error classes. The available resources are create_audio, create_character, and text_to_video. Keep RUNAPI_API_KEY in the environment or your secret manager; never commit API keys or callback secrets.
Links
- Model page: https://runapi.ai/models/gemini-omni
- SDK docs: https://runapi.ai/docs#sdk-gemini-omni
- Product docs: https://runapi.ai/docs#gemini-omni
- Flash Preview pricing and rate limits: https://runapi.ai/models/gemini-omni/flash-preview
- Provider comparison: https://runapi.ai/providers/google
- Full catalog: https://runapi.ai/models
License
Licensed under the Apache License, Version 2.0.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file runapi_gemini_omni-0.3.0.tar.gz.
File metadata
- Download URL: runapi_gemini_omni-0.3.0.tar.gz
- Upload date:
- Size: 6.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.31 {"installer":{"name":"uv","version":"0.11.31","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
896ebea6d21ffb99c4d2e0d7cc68e71dd43e34685e341f5aa964ed2d56cc36b7
|
|
| MD5 |
1ae957a764646b345a415129aeae2384
|
|
| BLAKE2b-256 |
efca82892bef32572a2633cb809177c36ebefcadd2dfac7007e2344683bbb863
|
File details
Details for the file runapi_gemini_omni-0.3.0-py3-none-any.whl.
File metadata
- Download URL: runapi_gemini_omni-0.3.0-py3-none-any.whl
- Upload date:
- Size: 8.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.31 {"installer":{"name":"uv","version":"0.11.31","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e9663dce6f4fbe963e6ff1aaf2f9de2cccf4598b54cbb3bc2778fca525b4c41c
|
|
| MD5 |
b4bf39a08f0aeac30c889bffe5260ab6
|
|
| BLAKE2b-256 |
362f29e06748eee3eadf7e9763194965aca9b6e383caec0b4d0fd96807b5382b
|
