together 1.5.17__py3-none-any.whl → 2.0.0a8__py3-none-any.whl

together/types/audio/transcription_create_params.py

@@ -0,0 +1,54 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List, Union
+from typing_extensions import Literal, Required, TypedDict
+
+from ..._types import FileTypes
+
+__all__ = ["TranscriptionCreateParams"]
+
+
+class TranscriptionCreateParams(TypedDict, total=False):
+    file: Required[FileTypes]
+    """Audio file to transcribe"""
+
+    diarize: bool
+    """Whether to enable speaker diarization.
+
+    When enabled, you will get the speaker id for each word in the transcription. In
+    the response, in the words array, you will get the speaker id for each word. In
+    addition, we also return the speaker_segments array which contains the speaker
+    id for each speaker segment along with the start and end time of the segment
+    along with all the words in the segment.
+
+    For eg - ... "speaker_segments": [ "speaker_id": "SPEAKER_00", "start": 0,
+    "end": 30.02, "words": [ { "id": 0, "word": "Tijana", "start": 0, "end": 11.475,
+    "speaker_id": "SPEAKER_00" }, ...
+    """
+
+    language: str
+    """Optional ISO 639-1 language code.
+
+    If `auto` is provided, language is auto-detected.
+    """
+
+    model: Literal["openai/whisper-large-v3"]
+    """Model to use for transcription"""
+
+    prompt: str
+    """Optional text to bias decoding."""
+
+    response_format: Literal["json", "verbose_json"]
+    """The format of the response"""
+
+    temperature: float
+    """Sampling temperature between 0.0 and 1.0"""
+
+    timestamp_granularities: Union[Literal["segment", "word"], List[Literal["segment", "word"]]]
+    """Controls level of timestamp detail in verbose_json.
+
+    Only used when response_format is verbose_json. Can be a single granularity or
+    an array to get multiple levels.
+    """

together/types/audio/transcription_create_response.py

@@ -0,0 +1,111 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Union, Optional
+from typing_extensions import Literal, TypeAlias
+
+from ..._models import BaseModel
+
+__all__ = [
+    "TranscriptionCreateResponse",
+    "AudioTranscriptionJsonResponse",
+    "AudioTranscriptionVerboseJsonResponse",
+    "AudioTranscriptionVerboseJsonResponseSegment",
+    "AudioTranscriptionVerboseJsonResponseSpeakerSegment",
+    "AudioTranscriptionVerboseJsonResponseSpeakerSegmentWord",
+    "AudioTranscriptionVerboseJsonResponseWord",
+]
+
+
+class AudioTranscriptionJsonResponse(BaseModel):
+    text: str
+    """The transcribed text"""
+
+
+class AudioTranscriptionVerboseJsonResponseSegment(BaseModel):
+    id: int
+    """Unique identifier for the segment"""
+
+    end: float
+    """End time of the segment in seconds"""
+
+    start: float
+    """Start time of the segment in seconds"""
+
+    text: str
+    """The text content of the segment"""
+
+
+class AudioTranscriptionVerboseJsonResponseSpeakerSegmentWord(BaseModel):
+    end: float
+    """End time of the word in seconds"""
+
+    start: float
+    """Start time of the word in seconds"""
+
+    word: str
+    """The word"""
+
+    speaker_id: Optional[str] = None
+    """The speaker id for the word (only when diarize is enabled)"""
+
+
+class AudioTranscriptionVerboseJsonResponseSpeakerSegment(BaseModel):
+    id: int
+    """Unique identifier for the speaker segment"""
+
+    end: float
+    """End time of the speaker segment in seconds"""
+
+    speaker_id: str
+    """The speaker identifier"""
+
+    start: float
+    """Start time of the speaker segment in seconds"""
+
+    text: str
+    """The full text spoken by this speaker in this segment"""
+
+    words: List[AudioTranscriptionVerboseJsonResponseSpeakerSegmentWord]
+    """Array of words spoken by this speaker in this segment"""
+
+
+class AudioTranscriptionVerboseJsonResponseWord(BaseModel):
+    end: float
+    """End time of the word in seconds"""
+
+    start: float
+    """Start time of the word in seconds"""
+
+    word: str
+    """The word"""
+
+    speaker_id: Optional[str] = None
+    """The speaker id for the word (only when diarize is enabled)"""
+
+
+class AudioTranscriptionVerboseJsonResponse(BaseModel):
+    duration: float
+    """The duration of the audio in seconds"""
+
+    language: str
+    """The language of the audio"""
+
+    segments: List[AudioTranscriptionVerboseJsonResponseSegment]
+    """Array of transcription segments"""
+
+    task: Literal["transcribe", "translate"]
+    """The task performed"""
+
+    text: str
+    """The transcribed text"""
+
+    speaker_segments: Optional[List[AudioTranscriptionVerboseJsonResponseSpeakerSegment]] = None
+    """Array of transcription speaker segments (only when diarize is enabled)"""
+
+    words: Optional[List[AudioTranscriptionVerboseJsonResponseWord]] = None
+    """
+    Array of transcription words (only when timestamp_granularities includes 'word')
+    """
+
+
+TranscriptionCreateResponse: TypeAlias = Union[AudioTranscriptionJsonResponse, AudioTranscriptionVerboseJsonResponse]

together/types/audio/translation_create_params.py

@@ -0,0 +1,40 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List, Union
+from typing_extensions import Literal, Required, TypedDict
+
+from ..._types import FileTypes
+
+__all__ = ["TranslationCreateParams"]
+
+
+class TranslationCreateParams(TypedDict, total=False):
+    file: Required[FileTypes]
+    """Audio file to translate"""
+
+    language: str
+    """Target output language.
+
+    Optional ISO 639-1 language code. If omitted, language is set to English.
+    """
+
+    model: Literal["openai/whisper-large-v3"]
+    """Model to use for translation"""
+
+    prompt: str
+    """Optional text to bias decoding."""
+
+    response_format: Literal["json", "verbose_json"]
+    """The format of the response"""
+
+    temperature: float
+    """Sampling temperature between 0.0 and 1.0"""
+
+    timestamp_granularities: Union[Literal["segment", "word"], List[Literal["segment", "word"]]]
+    """Controls level of timestamp detail in verbose_json.
+
+    Only used when response_format is verbose_json. Can be a single granularity or
+    an array to get multiple levels.
+    """

together/types/audio/translation_create_response.py

@@ -0,0 +1,70 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Union, Optional
+from typing_extensions import Literal, TypeAlias
+
+from ..._models import BaseModel
+
+__all__ = [
+    "TranslationCreateResponse",
+    "AudioTranslationJsonResponse",
+    "AudioTranslationVerboseJsonResponse",
+    "AudioTranslationVerboseJsonResponseSegment",
+    "AudioTranslationVerboseJsonResponseWord",
+]
+
+
+class AudioTranslationJsonResponse(BaseModel):
+    text: str
+    """The translated text"""
+
+
+class AudioTranslationVerboseJsonResponseSegment(BaseModel):
+    id: int
+    """Unique identifier for the segment"""
+
+    end: float
+    """End time of the segment in seconds"""
+
+    start: float
+    """Start time of the segment in seconds"""
+
+    text: str
+    """The text content of the segment"""
+
+
+class AudioTranslationVerboseJsonResponseWord(BaseModel):
+    end: float
+    """End time of the word in seconds"""
+
+    start: float
+    """Start time of the word in seconds"""
+
+    word: str
+    """The word"""
+
+    speaker_id: Optional[str] = None
+    """The speaker id for the word (only when diarize is enabled)"""
+
+
+class AudioTranslationVerboseJsonResponse(BaseModel):
+    duration: float
+    """The duration of the audio in seconds"""
+
+    language: str
+    """The target language of the translation"""
+
+    segments: List[AudioTranslationVerboseJsonResponseSegment]
+    """Array of translation segments"""
+
+    task: Literal["transcribe", "translate"]
+    """The task performed"""
+
+    text: str
+    """The translated text"""
+
+    words: Optional[List[AudioTranslationVerboseJsonResponseWord]] = None
+    """Array of translation words (only when timestamp_granularities includes 'word')"""
+
+
+TranslationCreateResponse: TypeAlias = Union[AudioTranslationJsonResponse, AudioTranslationVerboseJsonResponse]

together/types/audio/voice_list_response.py

@@ -0,0 +1,23 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+
+from ..._models import BaseModel
+
+__all__ = ["VoiceListResponse", "Data", "DataVoice"]
+
+
+class DataVoice(BaseModel):
+    id: str
+
+    name: str
+
+
+class Data(BaseModel):
+    model: str
+
+    voices: List[DataVoice]
+
+
+class VoiceListResponse(BaseModel):
+    data: List[Data]

together/types/audio_speech_stream_chunk.py

@@ -0,0 +1,16 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing_extensions import Literal
+
+from .._models import BaseModel
+
+__all__ = ["AudioSpeechStreamChunk"]
+
+
+class AudioSpeechStreamChunk(BaseModel):
+    b64: str
+    """base64 encoded audio stream"""
+
+    model: str
+
+    object: Literal["audio.tts.chunk"]

together/types/autoscaling.py

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .._models import BaseModel
+
+__all__ = ["Autoscaling"]
+
+
+class Autoscaling(BaseModel):
+    max_replicas: int
+    """The maximum number of replicas to scale up to under load"""
+
+    min_replicas: int
+    """The minimum number of replicas to maintain, even when there is no load"""

together/types/autoscaling_param.py

@@ -0,0 +1,15 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["AutoscalingParam"]
+
+
+class AutoscalingParam(TypedDict, total=False):
+    max_replicas: Required[int]
+    """The maximum number of replicas to scale up to under load"""
+
+    min_replicas: Required[int]
+    """The minimum number of replicas to maintain, even when there is no load"""

together/types/batch_create_params.py

@@ -0,0 +1,24 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+__all__ = ["BatchCreateParams"]
+
+
+class BatchCreateParams(TypedDict, total=False):
+    endpoint: Required[str]
+    """The endpoint to use for batch processing"""
+
+    input_file_id: Required[str]
+    """ID of the uploaded input file containing batch requests"""
+
+    completion_window: str
+    """Time window for batch completion (optional)"""
+
+    model_id: str
+    """Model to use for processing batch requests"""
+
+    priority: int
+    """Priority for batch processing (optional)"""

together/types/batch_create_response.py

@@ -0,0 +1,14 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from .._models import BaseModel
+from .batch_job import BatchJob
+
+__all__ = ["BatchCreateResponse"]
+
+
+class BatchCreateResponse(BaseModel):
+    job: Optional[BatchJob] = None
+
+    warning: Optional[str] = None

together/types/batch_job.py

@@ -0,0 +1,45 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+from datetime import datetime
+from typing_extensions import Literal
+
+from pydantic import Field as FieldInfo
+
+from .._models import BaseModel
+
+__all__ = ["BatchJob"]
+
+
+class BatchJob(BaseModel):
+    id: Optional[str] = None
+
+    completed_at: Optional[datetime] = None
+
+    created_at: Optional[datetime] = None
+
+    endpoint: Optional[str] = None
+
+    error: Optional[str] = None
+
+    error_file_id: Optional[str] = None
+
+    file_size_bytes: Optional[int] = None
+    """Size of input file in bytes"""
+
+    input_file_id: Optional[str] = None
+
+    job_deadline: Optional[datetime] = None
+
+    x_model_id: Optional[str] = FieldInfo(alias="model_id", default=None)
+    """Model used for processing requests"""
+
+    output_file_id: Optional[str] = None
+
+    progress: Optional[float] = None
+    """Completion progress (0.0 to 100)"""
+
+    status: Optional[Literal["VALIDATING", "IN_PROGRESS", "COMPLETED", "FAILED", "EXPIRED", "CANCELLED"]] = None
+    """Current status of the batch job"""
+
+    user_id: Optional[str] = None

together/types/batch_list_response.py

@@ -0,0 +1,10 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+from typing_extensions import TypeAlias
+
+from .batch_job import BatchJob
+
+__all__ = ["BatchListResponse"]
+
+BatchListResponse: TypeAlias = List[BatchJob]

together/types/chat/__init__.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .chat_completion import ChatCompletion as ChatCompletion
+from .chat_completion_chunk import ChatCompletionChunk as ChatCompletionChunk
+from .chat_completion_usage import ChatCompletionUsage as ChatCompletionUsage
+from .chat_completion_warning import ChatCompletionWarning as ChatCompletionWarning
+from .completion_create_params import CompletionCreateParams as CompletionCreateParams
+from .chat_completion_structured_message_text_param import (
+    ChatCompletionStructuredMessageTextParam as ChatCompletionStructuredMessageTextParam,
+)
+from .chat_completion_structured_message_image_url_param import (
+    ChatCompletionStructuredMessageImageURLParam as ChatCompletionStructuredMessageImageURLParam,
+)
+from .chat_completion_structured_message_video_url_param import (
+    ChatCompletionStructuredMessageVideoURLParam as ChatCompletionStructuredMessageVideoURLParam,
+)

together/types/chat/chat_completion.py

@@ -0,0 +1,60 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+from ..log_probs import LogProbs
+from ..tool_choice import ToolChoice
+from .chat_completion_usage import ChatCompletionUsage
+from .chat_completion_warning import ChatCompletionWarning
+
+__all__ = ["ChatCompletion", "Choice", "ChoiceMessage", "ChoiceMessageFunctionCall"]
+
+
+class ChoiceMessageFunctionCall(BaseModel):
+    arguments: str
+
+    name: str
+
+
+class ChoiceMessage(BaseModel):
+    content: Optional[str] = None
+
+    role: Literal["assistant"]
+
+    function_call: Optional[ChoiceMessageFunctionCall] = None
+
+    reasoning: Optional[str] = None
+
+    tool_calls: Optional[List[ToolChoice]] = None
+
+
+class Choice(BaseModel):
+    finish_reason: Optional[Literal["stop", "eos", "length", "tool_calls", "function_call"]] = None
+
+    index: Optional[int] = None
+
+    logprobs: Optional[LogProbs] = None
+
+    message: Optional[ChoiceMessage] = None
+
+    seed: Optional[int] = None
+
+    text: Optional[str] = None
+
+
+class ChatCompletion(BaseModel):
+    id: str
+
+    choices: List[Choice]
+
+    created: int
+
+    model: str
+
+    object: Literal["chat.completion"]
+
+    usage: Optional[ChatCompletionUsage] = None
+
+    warnings: Optional[List[ChatCompletionWarning]] = None

together/types/chat/chat_completion_chunk.py

@@ -0,0 +1,61 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from typing_extensions import Literal
+
+from ..._models import BaseModel
+from ..tool_choice import ToolChoice
+from .chat_completion_usage import ChatCompletionUsage
+from .chat_completion_warning import ChatCompletionWarning
+
+__all__ = ["ChatCompletionChunk", "Choice", "ChoiceDelta", "ChoiceDeltaFunctionCall"]
+
+
+class ChoiceDeltaFunctionCall(BaseModel):
+    arguments: str
+
+    name: str
+
+
+class ChoiceDelta(BaseModel):
+    role: Literal["system", "user", "assistant", "function", "tool"]
+
+    content: Optional[str] = None
+
+    function_call: Optional[ChoiceDeltaFunctionCall] = None
+
+    reasoning: Optional[str] = None
+
+    token_id: Optional[int] = None
+
+    tool_calls: Optional[List[ToolChoice]] = None
+
+
+class Choice(BaseModel):
+    delta: ChoiceDelta
+
+    finish_reason: Optional[Literal["stop", "eos", "length", "tool_calls", "function_call"]] = None
+
+    index: int
+
+    logprobs: Optional[float] = None
+
+    seed: Optional[int] = None
+
+
+class ChatCompletionChunk(BaseModel):
+    id: str
+
+    choices: List[Choice]
+
+    created: int
+
+    model: str
+
+    object: Literal["chat.completion.chunk"]
+
+    system_fingerprint: Optional[str] = None
+
+    usage: Optional[ChatCompletionUsage] = None
+
+    warnings: Optional[List[ChatCompletionWarning]] = None

together/types/chat/chat_completion_structured_message_image_url_param.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["ChatCompletionStructuredMessageImageURLParam", "ImageURL"]
+
+
+class ImageURL(TypedDict, total=False):
+    url: Required[str]
+    """The URL of the image"""
+
+
+class ChatCompletionStructuredMessageImageURLParam(TypedDict, total=False):
+    image_url: ImageURL
+
+    type: Literal["image_url"]

together/types/chat/chat_completion_structured_message_text_param.py

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["ChatCompletionStructuredMessageTextParam"]
+
+
+class ChatCompletionStructuredMessageTextParam(TypedDict, total=False):
+    text: Required[str]
+
+    type: Required[Literal["text"]]

together/types/chat/chat_completion_structured_message_video_url_param.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Literal, Required, TypedDict
+
+__all__ = ["ChatCompletionStructuredMessageVideoURLParam", "VideoURL"]
+
+
+class VideoURL(TypedDict, total=False):
+    url: Required[str]
+    """The URL of the video"""
+
+
+class ChatCompletionStructuredMessageVideoURLParam(TypedDict, total=False):
+    type: Required[Literal["video_url"]]
+
+    video_url: Required[VideoURL]

together/types/chat/chat_completion_usage.py

@@ -0,0 +1,13 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from ..._models import BaseModel
+
+__all__ = ["ChatCompletionUsage"]
+
+
+class ChatCompletionUsage(BaseModel):
+    completion_tokens: int
+
+    prompt_tokens: int
+
+    total_tokens: int

together/types/chat/chat_completion_warning.py

@@ -0,0 +1,9 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from ..._models import BaseModel
+
+__all__ = ["ChatCompletionWarning"]
+
+
+class ChatCompletionWarning(BaseModel):
+    message: str