runapi-gemini-tts 0.1.0__py3-none-any.whl

runapi/gemini_tts/__init__.py

@@ -0,0 +1,24 @@
+"""Gemini TTS client for RunAPI."""
+
+from runapi.core import (
+    AuthenticationError,
+    InsufficientCreditsError,
+    NotFoundError,
+    RateLimitError,
+    TaskFailedError,
+    TaskTimeoutError,
+    ValidationError,
+)
+
+from .client import GeminiTtsClient
+
+__all__ = [
+    "GeminiTtsClient",
+    "AuthenticationError",
+    "RateLimitError",
+    "InsufficientCreditsError",
+    "NotFoundError",
+    "ValidationError",
+    "TaskFailedError",
+    "TaskTimeoutError",
+]

runapi/gemini_tts/client.py

@@ -0,0 +1,19 @@
+"""Gemini TTS client."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from runapi.core import ClientOptions, HttpClient, resolve_api_key
+
+from .resources.text_to_speech import TextToSpeech
+
+
+class GeminiTtsClient:
+    """Client for multi-speaker Gemini TTS generation."""
+
+    def __init__(self, api_key: Optional[str] = None, **options: Any) -> None:
+        resolved_api_key = resolve_api_key(api_key)
+        client_options = ClientOptions(api_key=resolved_api_key, **options)
+        http = client_options.http_client or HttpClient(client_options)
+        self.text_to_speech = TextToSpeech(http)

runapi/gemini_tts/contract_gen.py

@@ -0,0 +1,37 @@
+CONTRACT = {
+    "text-to-speech": {
+        "models": ["gemini-2.5-pro-tts", "gemini-3.1-flash-tts"],
+        "fields_by_model": {
+            "gemini-2.5-pro-tts": {
+                "dialogue_turns": {
+                    "required": True
+                },
+                "model": {
+                    "required": True
+                },
+                "speakers": {
+                    "required": True
+                },
+                "temperature": {
+                    "min": 0,
+                    "max": 2
+                }
+            },
+            "gemini-3.1-flash-tts": {
+                "dialogue_turns": {
+                    "required": True
+                },
+                "model": {
+                    "required": True
+                },
+                "speakers": {
+                    "required": True
+                },
+                "temperature": {
+                    "min": 0,
+                    "max": 2
+                }
+            }
+        }
+    }
+}

runapi/gemini_tts/py.typed

@@ -0,0 +1 @@
+

runapi/gemini_tts/resources/__init__.py

@@ -0,0 +1,5 @@
+"""Gemini TTS resources."""
+
+from .text_to_speech import TextToSpeech
+
+__all__ = ["TextToSpeech"]

runapi/gemini_tts/resources/text_to_speech.py

@@ -0,0 +1,30 @@
+"""Gemini TTS text-to-speech resource."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from runapi.core import Resource, RequestOptions
+
+from ..contract_gen import CONTRACT
+from ..types import AudioTaskResponse, CompletedAudioTaskResponse
+
+
+class TextToSpeech(Resource):
+    """Generate multi-speaker speech from ordered dialogue turns."""
+
+    ENDPOINT = "/api/v1/gemini_tts/text_to_speech"
+    RESPONSE_CLASS = AudioTaskResponse
+    COMPLETED_RESPONSE_CLASS = CompletedAudioTaskResponse
+
+    def run(self, options: Optional[RequestOptions] = None, **params: Any) -> Any:
+        task = self.create(options=options, **params)
+        return self._poll_until_complete(lambda: self.get(task.id, options=options))
+
+    def create(self, options: Optional[RequestOptions] = None, **params: Any) -> Any:
+        compacted = self._compact_params(params)
+        self._validate_contract(CONTRACT["text-to-speech"], compacted)
+        return self._request("post", self.ENDPOINT, body=compacted, options=options)
+
+    def get(self, id: str, options: Optional[RequestOptions] = None) -> Any:
+        return self._request("get", f"{self.ENDPOINT}/{id}", options=options)

runapi/gemini_tts/types.py

@@ -0,0 +1,18 @@
+"""Gemini TTS response models."""
+
+from runapi.core import BaseModel, TaskResponse, optional, required
+
+
+class Audio(BaseModel):
+    url = required(str)
+
+
+class AudioTaskResponse(TaskResponse):
+    id = required(str)
+    status = optional(str, enum=lambda: TaskResponse.Status.ALL)
+    audios = optional([lambda: Audio])
+    error = optional(str)
+
+
+class CompletedAudioTaskResponse(AudioTaskResponse):
+    audios = required([lambda: Audio])

runapi_gemini_tts-0.1.0.dist-info/METADATA

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: runapi-gemini-tts
+Version: 0.1.0
+Summary: RunAPI Gemini TTS SDK for multi-speaker speech generation in JavaScript, Python, Ruby, Go, Java, and PHP
+Project-URL: Homepage, https://runapi.ai/models/gemini-tts
+Project-URL: Documentation, https://runapi.ai/docs#sdk-gemini-tts
+Project-URL: Source, https://github.com/runapi-ai/gemini-tts-sdk
+Project-URL: Issues, https://github.com/runapi-ai/gemini-tts-sdk/issues
+Project-URL: Changelog, https://github.com/runapi-ai/gemini-tts-sdk/blob/main/CHANGELOG.md
+Project-URL: Release Notes, https://github.com/runapi-ai/gemini-tts-sdk/releases/tag/python%2Fv0.1.0
+Author-email: RunAPI <contact@runapi.ai>
+License-Expression: Apache-2.0
+Keywords: api,audio,gemini,gemini-tts,golang,google,gradle,java,maven,python,ruby,runapi,runapi-ai,sdk,speech,text-to-speech,typescript
+Requires-Python: >=3.9
+Requires-Dist: runapi-core>=0.2.0
+Description-Content-Type: text/markdown
+
+# Gemini TTS Python SDK for RunAPI
+
+Install `runapi-gemini-tts` for keyword-based multi-speaker speech requests and normalized task responses.
+
+```bash
+pip install runapi-gemini-tts
+```
+
+```python
+from runapi.gemini_tts import GeminiTtsClient
+
+client = GeminiTtsClient()
+result = client.text_to_speech.run(
+    model="gemini-2.5-pro-tts",
+    speakers=[{"speaker_id": "Speaker 1", "voice_name": "Fenrir", "accent": "British (RP)", "style": "Deadpan", "pace": "Natural"}],
+    dialogue_turns=[{"speaker_id": "Speaker 1", "text": "Welcome."}],
+)
+```
+
+See the [model page](https://runapi.ai/models/gemini-tts) and [API reference](https://runapi.ai/docs#gemini-tts). Licensed under Apache-2.0.

runapi_gemini_tts-0.1.0.dist-info/RECORD

@@ -0,0 +1,10 @@
+runapi/gemini_tts/__init__.py,sha256=UdIgpEmtTFiweJRJ02gexliD9feJlmekt6_LqW85Duo,470
+runapi/gemini_tts/client.py,sha256=T513Uij_xBY8Uw7kTJ1es1RbSn7x8xNpcU0gkr6aifk,627
+runapi/gemini_tts/contract_gen.py,sha256=bRt0Mm005d4wGHA1ma-NiHQG9pbZfMZqG0grvgFFgMs,995
+runapi/gemini_tts/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+runapi/gemini_tts/types.py,sha256=nTrIzoPmCfZ9jGT-AaNaRUyI-G85KCW4eqSGAqqahKI,441
+runapi/gemini_tts/resources/__init__.py,sha256=eFjJmnfjqYswRAGaMqTlkffXmEcxk2oGhHHgAFC0JCU,98
+runapi/gemini_tts/resources/text_to_speech.py,sha256=esJdsIbtXIVSYCGyzjyWH6JoWEKHr6z5JzFkI4KHRPk,1186
+runapi_gemini_tts-0.1.0.dist-info/METADATA,sha256=y9cIYhcPLgca_byZZEI9Z24k3oF_TRJbl6ASh_yAbu4,1625
+runapi_gemini_tts-0.1.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+runapi_gemini_tts-0.1.0.dist-info/RECORD,,

runapi_gemini_tts-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any