meshapi 0.1.7__tar.gz → 0.1.9__tar.gz

{meshapi-0.1.7 → meshapi-0.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meshapi
-Version: 0.1.7
+Version: 0.1.9
 Summary: Official Python SDK for the MeshAPI AI model gateway
 Project-URL: Homepage, https://meshapi.ai
 Project-URL: Documentation, https://developers.meshapi.ai
@@ -189,7 +189,8 @@ reply = client.responses.create(
     )
 )
 
-# List background response jobs, or fetch one by id
+# List background response jobs, or fetch a persisted/background response by id.
+# Synchronous create responses are not guaranteed to be retrievable via get().
 jobs = client.responses.list(limit=20)
 job = client.responses.get("resp_abc123")
 ```
@@ -211,7 +212,12 @@ print(len(result.data[0].embedding))
 ## Audio (TTS, STT, voices)
 
 ```python
-from meshapi import SpeechParams, TranscriptionParams, ListVoicesParams
+from meshapi import (
+    AudioTranslationsParams,
+    ListVoicesParams,
+    SpeechParams,
+    TranscriptionParams,
+)
 
 # Text-to-speech — returns raw audio bytes
 audio_bytes = client.audio.synthesize(
@@ -224,24 +230,25 @@ audio_bytes = client.audio.synthesize(
 with open("output.wav", "wb") as f:
     f.write(audio_bytes)
 
-# Speech-to-text — submit transcription job
+# Speech-to-text — send raw audio bytes with a filename hint
+with open("audio.wav", "rb") as f:
+    file_bytes = f.read()
+
 result = client.audio.transcribe(
+    file_bytes,
     TranscriptionParams(
         model="sarvam/saaras:v3",
-        file=open("audio.wav", "rb").read(),
-        file_name="audio.wav",
-        language="en",
-    )
+        # Optional: language_code is model-specific (e.g. Sarvam expects "en-IN", not "en").
+    ),
+    filename="audio.wav",
 )
 print(result.text)
 
-# Translate audio to English
-translated = client.audio.translate(
-    TranscriptionParams(
-        model="sarvam/saaras:v3",
-        file=open("audio.wav", "rb").read(),
-        file_name="audio.wav",
-    )
+# Translate audio directly to English
+translated = client.audio.audio_translate(
+    file_bytes,
+    AudioTranslationsParams(model="openai/whisper-large-v3"),
+    filename="audio.wav",
 )
 print(translated.text)
 
@@ -599,7 +606,7 @@ from meshapi import (
     BulkEmbedRequest, BulkEmbedResponse,
     SearchRequest, SearchResponse, SearchResult,
     # audio
-    SpeechParams, TranscriptionParams, TranscriptionTranslateParams,
+    SpeechParams, TranscriptionParams, AudioTranslationsParams,
     TranscriptionResponse, ListVoicesParams,
     # video
     VideoGenerationParams, VideoContentItem,
@@ -616,7 +623,7 @@ from meshapi import (
 
 ```python
 import meshapi
-print(meshapi.__version__)  # "0.1.0"
+print(meshapi.__version__)  # "0.1.9"
 ```
 
 ## About Mesh API

{meshapi-0.1.7 → meshapi-0.1.9}/README.md

@@ -152,7 +152,8 @@ reply = client.responses.create(
     )
 )
 
-# List background response jobs, or fetch one by id
+# List background response jobs, or fetch a persisted/background response by id.
+# Synchronous create responses are not guaranteed to be retrievable via get().
 jobs = client.responses.list(limit=20)
 job = client.responses.get("resp_abc123")
 ```
@@ -174,7 +175,12 @@ print(len(result.data[0].embedding))
 ## Audio (TTS, STT, voices)
 
 ```python
-from meshapi import SpeechParams, TranscriptionParams, ListVoicesParams
+from meshapi import (
+    AudioTranslationsParams,
+    ListVoicesParams,
+    SpeechParams,
+    TranscriptionParams,
+)
 
 # Text-to-speech — returns raw audio bytes
 audio_bytes = client.audio.synthesize(
@@ -187,24 +193,25 @@ audio_bytes = client.audio.synthesize(
 with open("output.wav", "wb") as f:
     f.write(audio_bytes)
 
-# Speech-to-text — submit transcription job
+# Speech-to-text — send raw audio bytes with a filename hint
+with open("audio.wav", "rb") as f:
+    file_bytes = f.read()
+
 result = client.audio.transcribe(
+    file_bytes,
     TranscriptionParams(
         model="sarvam/saaras:v3",
-        file=open("audio.wav", "rb").read(),
-        file_name="audio.wav",
-        language="en",
-    )
+        # Optional: language_code is model-specific (e.g. Sarvam expects "en-IN", not "en").
+    ),
+    filename="audio.wav",
 )
 print(result.text)
 
-# Translate audio to English
-translated = client.audio.translate(
-    TranscriptionParams(
-        model="sarvam/saaras:v3",
-        file=open("audio.wav", "rb").read(),
-        file_name="audio.wav",
-    )
+# Translate audio directly to English
+translated = client.audio.audio_translate(
+    file_bytes,
+    AudioTranslationsParams(model="openai/whisper-large-v3"),
+    filename="audio.wav",
 )
 print(translated.text)
 
@@ -562,7 +569,7 @@ from meshapi import (
     BulkEmbedRequest, BulkEmbedResponse,
     SearchRequest, SearchResponse, SearchResult,
     # audio
-    SpeechParams, TranscriptionParams, TranscriptionTranslateParams,
+    SpeechParams, TranscriptionParams, AudioTranslationsParams,
     TranscriptionResponse, ListVoicesParams,
     # video
     VideoGenerationParams, VideoContentItem,
@@ -579,7 +586,7 @@ from meshapi import (
 
 ```python
 import meshapi
-print(meshapi.__version__)  # "0.1.0"
+print(meshapi.__version__)  # "0.1.9"
 ```
 
 ## About Mesh API

{meshapi-0.1.7 → meshapi-0.1.9}/meshapi/__init__.py

@@ -23,10 +23,6 @@ from ._types import (
     BulkEmbedResponse,
     BulkEmbedResult,
     ChatCompletionChunk,
-    DocumentListResponse,
-    DocumentResponse,
-    GenerateDocumentRequest,
-    ListDocumentsParams,
     ChatCompletionChunkChoice,
     ChatCompletionChunkDelta,
     ChatCompletionChoice,
@@ -122,7 +118,6 @@ from ._types import (
     UsageInfo,
 )
 from .resources.audio import AsyncAudioResource, AudioResource
-from .resources.documents import AsyncDocumentsResource, DocumentsResource
 from .resources.videos import AsyncVideosResource, VideosResource
 from .resources.batches import AsyncBatchesResource, BatchesResource
 from .resources.chat import AsyncChatResource, ChatResource
@@ -145,7 +140,7 @@ from .resources.realtime import (
 from .resources.responses import AsyncResponsesResource, ResponsesResource
 from .resources.templates import AsyncTemplatesResource, TemplatesResource
 
-__version__ = "0.1.7"
+__version__ = "0.1.9"
 __all__ = [
     "__version__",
     "MeshAPI",
@@ -287,13 +282,6 @@ __all__ = [
     "ListVoicesParams",
     "Voice",
     "VoicesResponse",
-    # Documents
-    "DocumentsResource",
-    "AsyncDocumentsResource",
-    "GenerateDocumentRequest",
-    "ListDocumentsParams",
-    "DocumentResponse",
-    "DocumentListResponse",
 ]
 
 
@@ -343,7 +331,6 @@ class MeshAPI:
         self.templates = TemplatesResource(http)
         self.images = ImagesResource(http)
         self.videos = VideosResource(http)
-        self.documents = DocumentsResource(http)
         self.audio = AudioResource(http)
         self.rag = RagResource(http)
         self.moderations = ModerationsResource(http)
@@ -407,7 +394,6 @@ class AsyncMeshAPI:
         self.templates = AsyncTemplatesResource(http)
         self.images = AsyncImagesResource(http)
         self.videos = AsyncVideosResource(http)
-        self.documents = AsyncDocumentsResource(http)
         self.audio = AsyncAudioResource(http)
         self.rag = AsyncRagResource(http)
         self.moderations = AsyncModerationsResource(http)

{meshapi-0.1.7 → meshapi-0.1.9}/meshapi/_http.py

@@ -34,7 +34,7 @@ _BACKOFF_BASE_MS = 500
 _BACKOFF_MAX_MS = 30_000
 
 _SDK_VERSION_HEADER = "X-MeshAPI-SDK"
-_SDK_VERSION_VALUE = "python/0.1.7"
+_SDK_VERSION_VALUE = "python/0.1.9"
 
 
 @dataclass

{meshapi-0.1.7 → meshapi-0.1.9}/meshapi/_types.py

@@ -1319,55 +1319,3 @@ class ImageEditParams(BaseModel):
     mask_feather: Optional[int] = None
 
 
-# ---------------------------------------------------------------------------
-# Documents — GET /v1/documents, POST /v1/documents/generate,
-#             GET /v1/documents/{document_id}
-# ---------------------------------------------------------------------------
-
-
-class GenerateDocumentRequest(BaseModel):
-    """Request body for POST /v1/documents/generate."""
-
-    model_config = ConfigDict(extra="ignore")
-
-    format: Literal["pdf", "docx", "pptx", "csv", "xlsx"]
-    prompt: str
-    model: Optional[str] = None
-    metadata: Optional[Dict[str, Any]] = None
-
-
-class ListDocumentsParams(BaseModel):
-    """Query params for GET /v1/documents."""
-
-    model_config = ConfigDict(extra="ignore")
-
-    limit: Optional[int] = Field(default=None, ge=1, le=200)
-    offset: Optional[int] = Field(default=None, ge=0)
-
-
-class DocumentResponse(BaseModel):
-    model_config = ConfigDict(extra="ignore")
-
-    document_id: str
-    status: str
-    format: str
-    model: str
-    title: Optional[str] = None
-    download_url: Optional[str] = None
-    expires_at: Optional[str] = None
-    size_bytes: Optional[int] = None
-    prompt_tokens: Optional[int] = None
-    completion_tokens: Optional[int] = None
-    total_tokens: Optional[int] = None
-    failure_reason: Optional[str] = None
-    created_at: Optional[str] = None
-    updated_at: Optional[str] = None
-
-
-class DocumentListResponse(BaseModel):
-    model_config = ConfigDict(extra="ignore")
-
-    documents: List[DocumentResponse]
-    total: int
-    limit: int
-    offset: int

{meshapi-0.1.7 → meshapi-0.1.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "meshapi"
-version = "0.1.7"
+version = "0.1.9"
 description = "Official Python SDK for the MeshAPI AI model gateway"
 readme = "README.md"
 requires-python = ">=3.9"

meshapi-0.1.7/meshapi/resources/documents.py

@@ -1,60 +0,0 @@
-"""Documents resource — /v1/documents endpoints."""
-
-from __future__ import annotations
-
-from typing import Optional
-from urllib.parse import quote
-
-from .._http import AsyncHttpClient, SyncHttpClient
-from .._types import (
-    DocumentListResponse,
-    DocumentResponse,
-    GenerateDocumentRequest,
-    ListDocumentsParams,
-)
-
-
-class DocumentsResource:
-    def __init__(self, http: SyncHttpClient) -> None:
-        self._http = http
-
-    def generate(self, params: GenerateDocumentRequest) -> DocumentResponse:
-        """POST /v1/documents/generate — generate a document."""
-        data = self._http.post("/v1/documents/generate", params.model_dump(exclude_none=True))
-        return DocumentResponse.model_validate(data)
-
-    def list(self, params: Optional[ListDocumentsParams] = None) -> DocumentListResponse:
-        """GET /v1/documents — list documents."""
-        query = None
-        if params is not None:
-            query = {k: str(v) for k, v in params.model_dump(exclude_none=True).items()} or None
-        data = self._http.get("/v1/documents", params=query)
-        return DocumentListResponse.model_validate(data)
-
-    def retrieve(self, document_id: str) -> DocumentResponse:
-        """GET /v1/documents/{document_id} — get a document."""
-        data = self._http.get(f"/v1/documents/{quote(document_id, safe='')}")
-        return DocumentResponse.model_validate(data)
-
-
-class AsyncDocumentsResource:
-    def __init__(self, http: AsyncHttpClient) -> None:
-        self._http = http
-
-    async def generate(self, params: GenerateDocumentRequest) -> DocumentResponse:
-        """POST /v1/documents/generate — generate a document."""
-        data = await self._http.post("/v1/documents/generate", params.model_dump(exclude_none=True))
-        return DocumentResponse.model_validate(data)
-
-    async def list(self, params: Optional[ListDocumentsParams] = None) -> DocumentListResponse:
-        """GET /v1/documents — list documents."""
-        query = None
-        if params is not None:
-            query = {k: str(v) for k, v in params.model_dump(exclude_none=True).items()} or None
-        data = await self._http.get("/v1/documents", params=query)
-        return DocumentListResponse.model_validate(data)
-
-    async def retrieve(self, document_id: str) -> DocumentResponse:
-        """GET /v1/documents/{document_id} — get a document."""
-        data = await self._http.get(f"/v1/documents/{quote(document_id, safe='')}")
-        return DocumentResponse.model_validate(data)