runapi-openai-tts 0.1.0__tar.gz

runapi_openai_tts-0.1.0/PKG-INFO

@@ -0,0 +1,24 @@
+Metadata-Version: 2.4
+Name: runapi-openai-tts
+Version: 0.1.0
+Summary: RunAPI OpenAI TTS SDK for speech generation in JavaScript, Python, Ruby, Go, Java, and PHP
+Project-URL: Homepage, https://runapi.ai/models/openai-tts
+Project-URL: Documentation, https://runapi.ai/docs#sdk-openai-tts
+Project-URL: Source, https://github.com/runapi-ai/openai-tts-sdk
+Project-URL: Issues, https://github.com/runapi-ai/openai-tts-sdk/issues
+Project-URL: Changelog, https://github.com/runapi-ai/openai-tts-sdk/blob/main/CHANGELOG.md
+Project-URL: Release Notes, https://github.com/runapi-ai/openai-tts-sdk/releases/tag/python%2Fv0.1.0
+Author-email: RunAPI <contact@runapi.ai>
+License-Expression: Apache-2.0
+Keywords: api,audio,golang,java,maven,openai,openai-tts,python,ruby,runapi,runapi-ai,sdk,speech,tts,typescript
+Requires-Python: >=3.9
+Requires-Dist: runapi-core>=0.2.0
+Description-Content-Type: text/markdown
+
+# OpenAI TTS Python SDK for RunAPI
+
+Install `runapi-openai-tts`, create `OpenaiTtsClient`, and call `client.text_to_speech.run(model="tts-1", text="Hello")`.
+
+Model details and pricing: https://runapi.ai/models/openai-tts
+
+Licensed under the Apache License, Version 2.0.

runapi_openai_tts-0.1.0/README.md

@@ -0,0 +1,7 @@
+# OpenAI TTS Python SDK for RunAPI
+
+Install `runapi-openai-tts`, create `OpenaiTtsClient`, and call `client.text_to_speech.run(model="tts-1", text="Hello")`.
+
+Model details and pricing: https://runapi.ai/models/openai-tts
+
+Licensed under the Apache License, Version 2.0.

runapi_openai_tts-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "runapi-openai-tts"
+version = "0.1.0"
+description = "RunAPI OpenAI TTS SDK for speech generation in JavaScript, Python, Ruby, Go, Java, and PHP"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "Apache-2.0"
+authors = [{ name = "RunAPI", email = "contact@runapi.ai" }]
+keywords = ["runapi", "runapi-ai", "openai", "openai-tts", "tts", "speech", "audio", "api", "sdk", "typescript", "python", "ruby", "golang", "java", "maven"]
+dependencies = ["runapi-core>=0.2.0"]
+
+[project.urls]
+Homepage = "https://runapi.ai/models/openai-tts"
+Documentation = "https://runapi.ai/docs#sdk-openai-tts"
+Source = "https://github.com/runapi-ai/openai-tts-sdk"
+Issues = "https://github.com/runapi-ai/openai-tts-sdk/issues"
+Changelog = "https://github.com/runapi-ai/openai-tts-sdk/blob/main/CHANGELOG.md"
+"Release Notes" = "https://github.com/runapi-ai/openai-tts-sdk/releases/tag/python%2Fv0.1.0"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/runapi"]
+
+[tool.uv]
+package = true
+
+[dependency-groups]
+dev = ["pytest>=8"]
+
+[tool.runapi]
+slug = "openai-tts"

runapi_openai_tts-0.1.0/src/runapi/openai_tts/__init__.py

@@ -0,0 +1,20 @@
+"""OpenAI TTS client for RunAPI."""
+
+from runapi.core import (
+    AuthenticationError,
+    InsufficientCreditsError,
+    NotFoundError,
+    RateLimitError,
+    ValidationError,
+)
+
+from .client import OpenaiTtsClient
+
+__all__ = [
+    "OpenaiTtsClient",
+    "AuthenticationError",
+    "RateLimitError",
+    "InsufficientCreditsError",
+    "NotFoundError",
+    "ValidationError",
+]

runapi_openai_tts-0.1.0/src/runapi/openai_tts/client.py

@@ -0,0 +1,19 @@
+"""OpenAI 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 OpenaiTtsClient:
+    """OpenAI TTS speech generation client."""
+
+    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_openai_tts-0.1.0/src/runapi/openai_tts/contract_gen.py

@@ -0,0 +1,21 @@
+CONTRACT = {
+    "text-to-speech": {
+        "models": ["tts-1", "tts-1-hd"],
+        "fields_by_model": {
+            "tts-1": {
+                "text": {
+                    "required": True,
+                    "max": 4096,
+                    "length": True
+                }
+            },
+            "tts-1-hd": {
+                "text": {
+                    "required": True,
+                    "max": 4096,
+                    "length": True
+                }
+            }
+        }
+    }
+}

runapi_openai_tts-0.1.0/src/runapi/openai_tts/py.typed

@@ -0,0 +1 @@
+

runapi_openai_tts-0.1.0/src/runapi/openai_tts/resources/__init__.py

@@ -0,0 +1,3 @@
+from .text_to_speech import TextToSpeech
+
+__all__ = ["TextToSpeech"]

runapi_openai_tts-0.1.0/src/runapi/openai_tts/resources/text_to_speech.py

@@ -0,0 +1,22 @@
+"""OpenAI TTS text-to-speech resource."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from runapi.core import RequestOptions, Resource
+
+from ..contract_gen import CONTRACT
+from ..types import TextToSpeechResponse
+
+
+class TextToSpeech(Resource):
+    """Generate a RunAPI-managed MP3 from text."""
+
+    ENDPOINT = "/api/v1/openai_tts/text_to_speech"
+    RESPONSE_CLASS = TextToSpeechResponse
+
+    def run(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)

runapi_openai_tts-0.1.0/src/runapi/openai_tts/types.py

@@ -0,0 +1,21 @@
+"""OpenAI TTS response models."""
+
+from runapi.core import BaseModel, optional, required
+
+
+class Audio(BaseModel):
+    """A RunAPI-managed MP3 audio result."""
+
+    url = required(str)
+    format = required(str)
+    mime_type = required(str)
+    size_bytes = required(int)
+
+
+class TextToSpeechResponse(BaseModel):
+    """Completed synchronous text-to-speech response."""
+
+    id = required(str)
+    status = required(str)
+    audios = required([lambda: Audio])
+    error = optional(str)

runapi_openai_tts-0.1.0/tests/test_client.py

@@ -0,0 +1,39 @@
+import pytest
+
+from runapi.core import config
+from runapi.core.errors import ValidationError
+from runapi.openai_tts import OpenaiTtsClient
+from runapi.openai_tts.types import TextToSpeechResponse
+
+
+class FakeHttp:
+    def __init__(self, *responses):
+        self._responses = list(responses)
+        self.calls = []
+
+    def request(self, method, path, body=None, options=None):
+        self.calls.append((method, path, body))
+        return self._responses.pop(0)
+
+
+@pytest.fixture(autouse=True)
+def reset_config(monkeypatch):
+    monkeypatch.delenv("RUNAPI_API_KEY", raising=False)
+    monkeypatch.setattr(config, "api_key", None)
+
+
+def test_run_posts_params_and_decodes_managed_audio():
+    fake = FakeHttp({"id": "task_1", "status": "completed", "audios": [{"url": "https://runapi.ai/audio.mp3", "format": "mp3", "mime_type": "audio/mpeg", "size_bytes": 128}]})
+    client = OpenaiTtsClient(api_key="k", http_client=fake)
+
+    result = client.text_to_speech.run(model="tts-1", text="Hello")
+
+    assert fake.calls == [("post", "/api/v1/openai_tts/text_to_speech", {"model": "tts-1", "text": "Hello"})]
+    assert isinstance(result, TextToSpeechResponse)
+    assert result.audios[0].mime_type == "audio/mpeg"
+
+
+def test_run_requires_text():
+    client = OpenaiTtsClient(api_key="k", http_client=FakeHttp())
+    with pytest.raises(ValidationError, match="text is required"):
+        client.text_to_speech.run(model="tts-1")