sarvamai 0.1.22a4__py3-none-any.whl → 0.1.22a8__py3-none-any.whl

sarvamai/types/doc_digitization_create_job_response.py

@@ -0,0 +1,37 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .doc_digitization_job_parameters import DocDigitizationJobParameters
+from .doc_digitization_job_state import DocDigitizationJobState
+from .storage_container_type import StorageContainerType
+
+
+class DocDigitizationCreateJobResponse(UniversalBaseModel):
+    job_id: str = pydantic.Field()
+    """
+    Unique job identifier (UUID)
+    """
+
+    storage_container_type: StorageContainerType = pydantic.Field()
+    """
+    Storage Container Type
+    """
+
+    job_parameters: DocDigitizationJobParameters = pydantic.Field()
+    """
+    Job configuration parameters
+    """
+
+    job_state: DocDigitizationJobState
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

sarvamai/types/doc_digitization_download_files_response.py

@@ -0,0 +1,47 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .doc_digitization_job_state import DocDigitizationJobState
+from .file_signed_url_details import FileSignedUrlDetails
+from .storage_container_type import StorageContainerType
+
+
+class DocDigitizationDownloadFilesResponse(UniversalBaseModel):
+    """
+    Response for download-files endpoint.
+    """
+
+    job_id: str = pydantic.Field()
+    """
+    Job identifier (UUID)
+    """
+
+    job_state: DocDigitizationJobState = pydantic.Field()
+    """
+    Current job state
+    """
+
+    storage_container_type: StorageContainerType = pydantic.Field()
+    """
+    Storage backend type
+    """
+
+    download_urls: typing.Dict[str, FileSignedUrlDetails] = pydantic.Field()
+    """
+    Map of filename to presigned download URL details
+    """
+
+    error_code: typing.Optional[str] = None
+    error_message: typing.Optional[str] = None
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

sarvamai/types/doc_digitization_error_code.py

@@ -0,0 +1,15 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+DocDigitizationErrorCode = typing.Union[
+    typing.Literal[
+        "invalid_request_error",
+        "internal_server_error",
+        "insufficient_quota_error",
+        "invalid_api_key_error",
+        "rate_limit_exceeded_error",
+        "high_load_error",
+    ],
+    typing.Any,
+]

sarvamai/types/doc_digitization_error_details.py

@@ -0,0 +1,33 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .doc_digitization_error_code import DocDigitizationErrorCode
+
+
+class DocDigitizationErrorDetails(UniversalBaseModel):
+    message: str = pydantic.Field()
+    """
+    Message describing the error
+    """
+
+    code: DocDigitizationErrorCode = pydantic.Field()
+    """
+    Error code for the specific error that has occurred.
+    """
+
+    request_id: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Unique identifier for the request. Format: date_UUID4
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

sarvamai/types/doc_digitization_error_message.py

@@ -0,0 +1,23 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .doc_digitization_error_details import DocDigitizationErrorDetails
+
+
+class DocDigitizationErrorMessage(UniversalBaseModel):
+    error: DocDigitizationErrorDetails = pydantic.Field()
+    """
+    Error details
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

sarvamai/types/doc_digitization_job_detail.py

@@ -0,0 +1,74 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .doc_digitization_job_detail_state import DocDigitizationJobDetailState
+from .doc_digitization_page_error import DocDigitizationPageError
+from .task_file_details import TaskFileDetails
+
+
+class DocDigitizationJobDetail(UniversalBaseModel):
+    """
+    Processing details for a single input file with page-level metrics.
+    """
+
+    inputs: typing.List[TaskFileDetails] = pydantic.Field()
+    """
+    Input file(s) for this task
+    """
+
+    outputs: typing.List[TaskFileDetails] = pydantic.Field()
+    """
+    Output file(s) produced
+    """
+
+    state: DocDigitizationJobDetailState = pydantic.Field()
+    """
+    Processing state for this file
+    """
+
+    total_pages: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Total pages/images in the input file
+    """
+
+    pages_processed: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Number of pages processed so far
+    """
+
+    pages_succeeded: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Number of pages successfully processed
+    """
+
+    pages_failed: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Number of pages that failed processing
+    """
+
+    error_message: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Error message if processing failed
+    """
+
+    error_code: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Standardized error code if failed
+    """
+
+    page_errors: typing.Optional[typing.List[DocDigitizationPageError]] = pydantic.Field(default=None)
+    """
+    Detailed errors for each failed page
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

sarvamai/types/doc_digitization_job_detail_state.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+DocDigitizationJobDetailState = typing.Union[
+    typing.Literal["Pending", "Running", "Success", "PartialSuccess", "Failed"], typing.Any
+]

sarvamai/types/doc_digitization_job_parameters.py

@@ -0,0 +1,33 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .doc_digitization_output_format import DocDigitizationOutputFormat
+from .doc_digitization_supported_language import DocDigitizationSupportedLanguage
+
+
+class DocDigitizationJobParameters(UniversalBaseModel):
+    """
+    Job parameters for document digitization.
+    """
+
+    language: typing.Optional[DocDigitizationSupportedLanguage] = pydantic.Field(default=None)
+    """
+    ISO language code for the document
+    """
+
+    output_format: typing.Optional[DocDigitizationOutputFormat] = pydantic.Field(default=None)
+    """
+    Output format: html or md
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

sarvamai/types/doc_digitization_job_state.py

@@ -0,0 +1,7 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+DocDigitizationJobState = typing.Union[
+    typing.Literal["Accepted", "Pending", "Running", "Completed", "PartiallyCompleted", "Failed"], typing.Any
+]

sarvamai/types/doc_digitization_job_status_response.py

@@ -0,0 +1,75 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import datetime as dt
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .doc_digitization_job_detail import DocDigitizationJobDetail
+from .doc_digitization_job_state import DocDigitizationJobState
+from .storage_container_type import StorageContainerType
+
+
+class DocDigitizationJobStatusResponse(UniversalBaseModel):
+    """
+    Response model for job status endpoint.
+    """
+
+    job_id: str = pydantic.Field()
+    """
+    Job identifier (UUID)
+    """
+
+    job_state: DocDigitizationJobState = pydantic.Field()
+    """
+    Current job state
+    """
+
+    created_at: dt.datetime = pydantic.Field()
+    """
+    Job creation timestamp (ISO 8601)
+    """
+
+    updated_at: dt.datetime = pydantic.Field()
+    """
+    Last update timestamp (ISO 8601)
+    """
+
+    storage_container_type: StorageContainerType = pydantic.Field()
+    """
+    Storage backend type
+    """
+
+    total_files: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Total input files (always 1)
+    """
+
+    successful_files_count: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Files that completed successfully
+    """
+
+    failed_files_count: typing.Optional[int] = pydantic.Field(default=None)
+    """
+    Files that failed
+    """
+
+    error_message: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Job-level error message
+    """
+
+    job_details: typing.Optional[typing.List[DocDigitizationJobDetail]] = pydantic.Field(default=None)
+    """
+    Per-file processing details with page metrics
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

sarvamai/types/doc_digitization_output_format.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+DocDigitizationOutputFormat = typing.Union[typing.Literal["html", "md"], typing.Any]

sarvamai/types/doc_digitization_page_error.py

@@ -0,0 +1,36 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+
+
+class DocDigitizationPageError(UniversalBaseModel):
+    """
+    Error details for a specific page.
+    """
+
+    page_number: int = pydantic.Field()
+    """
+    Page number that failed
+    """
+
+    error_code: str = pydantic.Field()
+    """
+    Standardized error code
+    """
+
+    error_message: str = pydantic.Field()
+    """
+    Human-readable error description
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

sarvamai/types/doc_digitization_supported_language.py

@@ -0,0 +1,32 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+DocDigitizationSupportedLanguage = typing.Union[
+    typing.Literal[
+        "hi",
+        "en",
+        "bn",
+        "gu",
+        "kn",
+        "ml",
+        "mr",
+        "or",
+        "pa",
+        "ta",
+        "te",
+        "ur",
+        "as",
+        "bodo",
+        "doi",
+        "ks",
+        "kok",
+        "mai",
+        "mni",
+        "ne",
+        "sa",
+        "sat",
+        "sd",
+    ],
+    typing.Any,
+]

sarvamai/types/doc_digitization_upload_files_response.py

@@ -0,0 +1,44 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .doc_digitization_job_state import DocDigitizationJobState
+from .file_signed_url_details import FileSignedUrlDetails
+from .storage_container_type import StorageContainerType
+
+
+class DocDigitizationUploadFilesResponse(UniversalBaseModel):
+    """
+    Response with presigned upload URLs
+    """
+
+    job_id: str = pydantic.Field()
+    """
+    Job identifier
+    """
+
+    job_state: DocDigitizationJobState = pydantic.Field()
+    """
+    Current job state
+    """
+
+    upload_urls: typing.Dict[str, FileSignedUrlDetails] = pydantic.Field()
+    """
+    Map of filename to presigned upload URL details
+    """
+
+    storage_container_type: StorageContainerType = pydantic.Field()
+    """
+    Storage backend type
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

sarvamai/types/doc_digitization_webhook_callback.py

@@ -0,0 +1,31 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+import pydantic
+from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+
+
+class DocDigitizationWebhookCallback(UniversalBaseModel):
+    """
+    Webhook configuration for job completion notification
+    """
+
+    url: str = pydantic.Field()
+    """
+    HTTPS webhook URL to call upon job completion (HTTP not allowed)
+    """
+
+    auth_token: typing.Optional[str] = pydantic.Field(default=None)
+    """
+    Authorization token sent as X-SARVAM-JOB-CALLBACK-TOKEN header
+    """
+
+    if IS_PYDANTIC_V2:
+        model_config: typing.ClassVar[pydantic.ConfigDict] = pydantic.ConfigDict(extra="allow", frozen=True)  # type: ignore # Pydantic v2
+    else:
+
+        class Config:
+            frozen = True
+            smart_union = True
+            extra = pydantic.Extra.allow

sarvamai/types/mode.py

@@ -0,0 +1,5 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+Mode = typing.Union[typing.Literal["transcribe", "translate", "verbatim", "translit", "codemix"], typing.Any]

sarvamai/types/speech_to_text_job_parameters.py

@@ -4,6 +4,7 @@ import typing
 
 import pydantic
 from ..core.pydantic_utilities import IS_PYDANTIC_V2, UniversalBaseModel
+from .mode import Mode
 from .speech_to_text_model import SpeechToTextModel
 from .speech_to_text_translate_language import SpeechToTextTranslateLanguage
 
@@ -11,12 +12,52 @@ from .speech_to_text_translate_language import SpeechToTextTranslateLanguage
 class SpeechToTextJobParameters(UniversalBaseModel):
     language_code: typing.Optional[SpeechToTextTranslateLanguage] = pydantic.Field(default=None)
     """
-    Language code
+    Specifies the language of the input audio in BCP-47 format.
+    
+    **Available Options:**
+    - `unknown` (default): Use when the language is not known; the API will auto-detect.
+    - `hi-IN`: Hindi
+    - `bn-IN`: Bengali
+    - `kn-IN`: Kannada
+    - `ml-IN`: Malayalam
+    - `mr-IN`: Marathi
+    - `od-IN`: Odia
+    - `pa-IN`: Punjabi
+    - `ta-IN`: Tamil
+    - `te-IN`: Telugu
+    - `en-IN`: English
+    - `gu-IN`: Gujarati
     """
 
     model: typing.Optional[SpeechToTextModel] = pydantic.Field(default=None)
     """
-    Model to be used for speech to text
+    Model to be used for speech to text.
+    
+    - **saarika:v2.5** (default): Transcribes audio in the spoken language.
+    
+    - **saaras:v3**: State-of-the-art model with flexible output formats. Supports multiple modes via the `mode` parameter: transcribe, translate, verbatim, translit, codemix.
+    """
+
+    mode: typing.Optional[Mode] = pydantic.Field(default=None)
+    """
+    Mode of operation. **Only applicable when using saaras:v3 model.**
+    
+    Example audio: 'मेरा फोन नंबर है 9840950950'
+    
+    - **transcribe** (default): Standard transcription in the original language with proper formatting and number normalization.
+      - Output: `मेरा फोन नंबर है 9840950950`
+    
+    - **translate**: Translates speech from any supported Indic language to English.
+      - Output: `My phone number is 9840950950`
+    
+    - **verbatim**: Exact word-for-word transcription without normalization, preserving filler words and spoken numbers as-is.
+      - Output: `मेरा फोन नंबर है नौ आठ चार zero नौ पांच zero नौ पांच zero`
+    
+    - **translit**: Romanization - Transliterates speech to Latin/Roman script only.
+      - Output: `mera phone number hai 9840950950`
+    
+    - **codemix**: Code-mixed text with English words in English and Indic words in native script.
+      - Output: `मेरा phone number है 9840950950`
     """
 
     with_timestamps: typing.Optional[bool] = pydantic.Field(default=None)

sarvamai/types/speech_to_text_model.py

@@ -2,4 +2,4 @@
 
 import typing
 
-SpeechToTextModel = typing.Literal["saarika:v2.5"]
+SpeechToTextModel = typing.Union[typing.Literal["saarika:v2.5", "saaras:v3"], typing.Any]

sarvamai/types/speech_to_text_translate_job_parameters.py

@@ -15,7 +15,10 @@ class SpeechToTextTranslateJobParameters(UniversalBaseModel):
 
     model: typing.Optional[SpeechToTextTranslateModel] = pydantic.Field(default=None)
     """
-    Model to be used for converting speech to text in target language
+    Model to be used for speech to text translation.
+    
+    - **saaras:v2.5** (default): Translation model that translates audio from any spoken Indic language to English.
+      - Example: Hindi audio → English text output
     """
 
     with_diarization: typing.Optional[bool] = pydantic.Field(default=None)

sarvamai/types/text_to_speech_model.py

@@ -2,4 +2,4 @@
 
 import typing
 
-TextToSpeechModel = typing.Literal["bulbul:v2"]
+TextToSpeechModel = typing.Union[typing.Literal["bulbul:v2", "bulbul:v3-beta"], typing.Any]

sarvamai/types/text_to_speech_speaker.py

@@ -3,5 +3,39 @@
 import typing
 
 TextToSpeechSpeaker = typing.Union[
-    typing.Literal["anushka", "abhilash", "manisha", "vidya", "arya", "karun", "hitesh"], typing.Any
+    typing.Literal[
+        "anushka",
+        "abhilash",
+        "manisha",
+        "vidya",
+        "arya",
+        "karun",
+        "hitesh",
+        "aditya",
+        "ritu",
+        "priya",
+        "neha",
+        "rahul",
+        "pooja",
+        "rohan",
+        "simran",
+        "kavya",
+        "amit",
+        "dev",
+        "ishita",
+        "shreya",
+        "ratan",
+        "varun",
+        "manan",
+        "sumit",
+        "roopa",
+        "kabir",
+        "aayan",
+        "shubh",
+        "ashutosh",
+        "advait",
+        "amelia",
+        "sophia",
+    ],
+    typing.Any,
 ]

{sarvamai-0.1.22a4.dist-info → sarvamai-0.1.22a8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: sarvamai
-Version: 0.1.22a4
+Version: 0.1.22a8
 Summary: 
 Requires-Python: >=3.8,<4.0
 Classifier: Intended Audience :: Developers