together 2.0.0a7__py3-none-any.whl → 2.0.0a9__py3-none-any.whl

together/_streaming.py

@@ -55,30 +55,31 @@ class Stream(Generic[_T]):
         process_data = self._client._process_response_data
         iterator = self._iter_events()
 
-        for sse in iterator:
-            if sse.data.startswith("[DONE]"):
-                break
-
-            if sse.event is None:
-                data = sse.json()
-                if is_mapping(data) and data.get("error"):
-                    message = None
-                    error = data.get("error")
-                    if is_mapping(error):
-                        message = error.get("message")
-                    if not message or not isinstance(message, str):
-                        message = "An error occurred during streaming"
-
-                    raise APIError(
-                        message=message,
-                        request=self.response.request,
-                        body=data["error"],
-                    )
-
-                yield process_data(data=data, cast_to=cast_to, response=response)
-
-        # As we might not fully consume the response stream, we need to close it explicitly
-        response.close()
+        try:
+            for sse in iterator:
+                if sse.data.startswith("[DONE]"):
+                    break
+
+                if sse.event is None:
+                    data = sse.json()
+                    if is_mapping(data) and data.get("error"):
+                        message = None
+                        error = data.get("error")
+                        if is_mapping(error):
+                            message = error.get("message")
+                        if not message or not isinstance(message, str):
+                            message = "An error occurred during streaming"
+
+                        raise APIError(
+                            message=message,
+                            request=self.response.request,
+                            body=data["error"],
+                        )
+
+                    yield process_data(data=data, cast_to=cast_to, response=response)
+        finally:
+            # Ensure the response is closed even if the consumer doesn't read all data
+            response.close()
 
     def __enter__(self) -> Self:
         return self
@@ -137,30 +138,31 @@ class AsyncStream(Generic[_T]):
         process_data = self._client._process_response_data
         iterator = self._iter_events()
 
-        async for sse in iterator:
-            if sse.data.startswith("[DONE]"):
-                break
-
-            if sse.event is None:
-                data = sse.json()
-                if is_mapping(data) and data.get("error"):
-                    message = None
-                    error = data.get("error")
-                    if is_mapping(error):
-                        message = error.get("message")
-                    if not message or not isinstance(message, str):
-                        message = "An error occurred during streaming"
-
-                    raise APIError(
-                        message=message,
-                        request=self.response.request,
-                        body=data["error"],
-                    )
-
-                yield process_data(data=data, cast_to=cast_to, response=response)
-
-        # As we might not fully consume the response stream, we need to close it explicitly
-        await response.aclose()
+        try:
+            async for sse in iterator:
+                if sse.data.startswith("[DONE]"):
+                    break
+
+                if sse.event is None:
+                    data = sse.json()
+                    if is_mapping(data) and data.get("error"):
+                        message = None
+                        error = data.get("error")
+                        if is_mapping(error):
+                            message = error.get("message")
+                        if not message or not isinstance(message, str):
+                            message = "An error occurred during streaming"
+
+                        raise APIError(
+                            message=message,
+                            request=self.response.request,
+                            body=data["error"],
+                        )
+
+                    yield process_data(data=data, cast_to=cast_to, response=response)
+        finally:
+            # Ensure the response is closed even if the consumer doesn't read all data
+            await response.aclose()
 
     async def __aenter__(self) -> Self:
         return self

together/_utils/_utils.py

@@ -373,7 +373,7 @@ def get_required_header(headers: HeadersLike, header: str) -> str:
     lower_header = header.lower()
     if is_mapping_t(headers):
         # mypy doesn't understand the type narrowing here
-        for k, v in headers.items():  # type: ignore[misc, has-type]
+        for k, v in headers.items():  # type: ignore[misc, has-type, attr-defined]
             if k.lower() == lower_header and isinstance(v, str):  # type: ignore[has-type]
                 return v  # type: ignore[has-type]
 

together/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "together"
-__version__ = "2.0.0-alpha.7"  # x-release-please-version
+__version__ = "2.0.0-alpha.9"  # x-release-please-version

together/lib/cli/api/endpoints.py

@@ -128,8 +128,7 @@ def endpoints(ctx: click.Context) -> None:
     help="Start endpoint in specified availability zone (e.g., us-central-4b)",
 )
 @click.option(
-    "--wait",
-    is_flag=True,
+    "--wait/--no-wait",
     default=True,
     help="Wait for the endpoint to be ready after creation",
 )
@@ -272,7 +271,7 @@ def fetch_and_print_hardware_options(client: Together, model: str | None, print_
 
 @endpoints.command()
 @click.argument("endpoint-id", required=True)
-@click.option("--wait", is_flag=True, default=True, help="Wait for the endpoint to stop")
+@click.option("--wait/--no-wait", default=True, help="Wait for the endpoint to stop")
 @click.pass_obj
 @handle_api_errors
 def stop(client: Together, endpoint_id: str, wait: bool) -> None:
@@ -293,7 +292,7 @@ def stop(client: Together, endpoint_id: str, wait: bool) -> None:
 
 @endpoints.command()
 @click.argument("endpoint-id", required=True)
-@click.option("--wait", is_flag=True, default=True, help="Wait for the endpoint to start")
+@click.option("--wait/--no-wait", default=True, help="Wait for the endpoint to start")
 @click.pass_obj
 @handle_api_errors
 def start(client: Together, endpoint_id: str, wait: bool) -> None:

together/lib/types/fine_tuning.py

@@ -70,9 +70,6 @@ class FinetuneEventLevels(str, Enum):
     INFO = "Info"
     WARNING = "Warning"
     ERROR = "Error"
-    LEGACY_INFO = "info"
-    LEGACY_IWARNING = "warning"
-    LEGACY_IERROR = "error"
 
 
 class FinetuneEvent(BaseModel):
@@ -85,7 +82,7 @@ class FinetuneEvent(BaseModel):
     # created at datetime stamp
     created_at: Union[str, None] = None
     # event log level
-    level: Union[FinetuneEventLevels, None] = None
+    level: Union[FinetuneEventLevels, str, None] = None
     # event message string
     message: Union[str, None] = None
     # event type
@@ -120,7 +117,20 @@ class LoRATrainingType(BaseModel):
     type: Literal["Lora"] = "Lora"
 
 
-TrainingType: TypeAlias = Union[FullTrainingType, LoRATrainingType]
+class UnknownTrainingType(BaseModel):
+    """
+    Catch-all for unknown training types (forward compatibility).
+    Accepts any training type not explicitly defined.
+    """
+
+    type: str
+
+
+TrainingType: TypeAlias = Union[
+    FullTrainingType,
+    LoRATrainingType,
+    UnknownTrainingType,
+]
 
 
 class FinetuneFullTrainingLimits(BaseModel):
@@ -163,7 +173,19 @@ class TrainingMethodDPO(BaseModel):
     simpo_gamma: Union[float, None] = None
 
 
-TrainingMethod: TypeAlias = Union[TrainingMethodSFT, TrainingMethodDPO]
+class TrainingMethodUnknown(BaseModel):
+    """
+    Catch-all for unknown training methods (forward compatibility).
+    Accepts any training method not explicitly defined.
+    """
+
+    method: str
+
+TrainingMethod: TypeAlias = Union[
+    TrainingMethodSFT,
+    TrainingMethodDPO,
+    TrainingMethodUnknown,
+]
 
 
 class FinetuneTrainingLimits(BaseModel):
@@ -175,31 +197,67 @@ class FinetuneTrainingLimits(BaseModel):
 
 
 class LinearLRSchedulerArgs(BaseModel):
+    """
+    Linear learning rate scheduler arguments
+    """
+
     min_lr_ratio: Union[float, None] = 0.0
 
 
 class CosineLRSchedulerArgs(BaseModel):
+    """
+    Cosine learning rate scheduler arguments
+    """
+
     min_lr_ratio: Union[float, None] = 0.0
     num_cycles: Union[float, None] = 0.5
 
 
 class LinearLRScheduler(BaseModel):
+    """
+    Linear learning rate scheduler
+    """
+
     lr_scheduler_type: Literal["linear"] = "linear"
     lr_scheduler_args: Union[LinearLRSchedulerArgs, None] = None
 
 
 class CosineLRScheduler(BaseModel):
+    """
+    Cosine learning rate scheduler
+    """
+
     lr_scheduler_type: Literal["cosine"] = "cosine"
     lr_scheduler_args: Union[CosineLRSchedulerArgs, None] = None
 
 
-# placeholder for old fine-tuning jobs with no lr_scheduler_type specified
 class EmptyLRScheduler(BaseModel):
+    """
+    Empty learning rate scheduler
+
+    Placeholder for old fine-tuning jobs with no lr_scheduler_type specified
+    """
+
     lr_scheduler_type: Literal[""]
     lr_scheduler_args: None = None
 
+class UnknownLRScheduler(BaseModel):
+    """
+    Unknown learning rate scheduler
+
+    Catch-all for unknown LR scheduler types (forward compatibility)
+    """
+
+    lr_scheduler_type: str
+    lr_scheduler_args: Optional[Any] = None
+
 
-FinetuneLRScheduler: TypeAlias = Union[LinearLRScheduler, CosineLRScheduler, EmptyLRScheduler]
+FinetuneLRScheduler: TypeAlias = Union[
+    LinearLRScheduler,
+    CosineLRScheduler,
+    EmptyLRScheduler,
+    UnknownLRScheduler,
+]
 
 
 class FinetuneResponse(BaseModel):
@@ -213,8 +271,8 @@ class FinetuneResponse(BaseModel):
     created_at: datetime
     """Creation timestamp of the fine-tune job"""
 
-    status: Optional[FinetuneJobStatus] = None
-    """Status of the fine-tune job"""
+    status: Optional[Union[FinetuneJobStatus, str]] = None
+    """Status of the fine-tune job (accepts known enum values or string for forward compatibility)"""
 
     updated_at: datetime
     """Last update timestamp of the fine-tune job"""
@@ -222,8 +280,8 @@ class FinetuneResponse(BaseModel):
     batch_size: Optional[int] = None
     """Batch size used for training"""
 
-    events: Optional[List[FinetuneEvent]] = None
-    """Events related to this fine-tune job"""
+    events: Optional[List[Union[FinetuneEvent, str]]] = None
+    """Events related to this fine-tune job (accepts known enum values or string for forward compatibility)"""
 
     from_checkpoint: Optional[str] = None
     """Checkpoint used to continue training"""
@@ -361,7 +419,7 @@ class FinetuneRequest(BaseModel):
     # training learning rate
     learning_rate: float
     # learning rate scheduler type and args
-    lr_scheduler: Union[LinearLRScheduler, CosineLRScheduler, None] = None
+    lr_scheduler: Union[FinetuneLRScheduler, None] = None
     # learning rate warmup ratio
     warmup_ratio: float
     # max gradient norm
@@ -387,7 +445,7 @@ class FinetuneRequest(BaseModel):
     # training type
     training_type: Union[TrainingType, None] = None
     # training method
-    training_method: Union[TrainingMethodSFT, TrainingMethodDPO] = Field(default_factory=TrainingMethodSFT)
+    training_method: TrainingMethod = Field(default_factory=TrainingMethodSFT)
     # from step
     from_checkpoint: Union[str, None] = None
     from_hf_model: Union[str, None] = None

together/resources/audio/transcriptions.py

@@ -50,6 +50,8 @@ class TranscriptionsResource(SyncAPIResource):
         file: FileTypes,
         diarize: bool | Omit = omit,
         language: str | Omit = omit,
+        max_speakers: int | Omit = omit,
+        min_speakers: int | Omit = omit,
         model: Literal["openai/whisper-large-v3"] | Omit = omit,
         prompt: str | Omit = omit,
         response_format: Literal["json", "verbose_json"] | Omit = omit,
@@ -82,6 +84,12 @@ class TranscriptionsResource(SyncAPIResource):
           language: Optional ISO 639-1 language code. If `auto` is provided, language is
               auto-detected.
 
+          max_speakers: Maximum number of speakers expected in the audio. Used to improve diarization
+              accuracy when the approximate number of speakers is known.
+
+          min_speakers: Minimum number of speakers expected in the audio. Used to improve diarization
+              accuracy when the approximate number of speakers is known.
+
           model: Model to use for transcription
 
           prompt: Optional text to bias decoding.
@@ -107,6 +115,8 @@ class TranscriptionsResource(SyncAPIResource):
                 "file": file,
                 "diarize": diarize,
                 "language": language,
+                "max_speakers": max_speakers,
+                "min_speakers": min_speakers,
                 "model": model,
                 "prompt": prompt,
                 "response_format": response_format,
@@ -161,6 +171,8 @@ class AsyncTranscriptionsResource(AsyncAPIResource):
         file: FileTypes,
         diarize: bool | Omit = omit,
         language: str | Omit = omit,
+        max_speakers: int | Omit = omit,
+        min_speakers: int | Omit = omit,
         model: Literal["openai/whisper-large-v3"] | Omit = omit,
         prompt: str | Omit = omit,
         response_format: Literal["json", "verbose_json"] | Omit = omit,
@@ -193,6 +205,12 @@ class AsyncTranscriptionsResource(AsyncAPIResource):
           language: Optional ISO 639-1 language code. If `auto` is provided, language is
               auto-detected.
 
+          max_speakers: Maximum number of speakers expected in the audio. Used to improve diarization
+              accuracy when the approximate number of speakers is known.
+
+          min_speakers: Minimum number of speakers expected in the audio. Used to improve diarization
+              accuracy when the approximate number of speakers is known.
+
           model: Model to use for transcription
 
           prompt: Optional text to bias decoding.
@@ -218,6 +236,8 @@ class AsyncTranscriptionsResource(AsyncAPIResource):
                 "file": file,
                 "diarize": diarize,
                 "language": language,
+                "max_speakers": max_speakers,
+                "min_speakers": min_speakers,
                 "model": model,
                 "prompt": prompt,
                 "response_format": response_format,

together/resources/fine_tuning.py

@@ -291,7 +291,7 @@ class FineTuningResource(SyncAPIResource):
         self,
         id: str,
         *,
-        force: bool,
+        force: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -374,7 +374,7 @@ class FineTuningResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> BinaryAPIResponse:
         """
-        Download a compressed fine-tuned model or checkpoint.
+        Receive a compressed fine-tuned model or checkpoint.
 
         Args:
           ft_id: Fine-tune ID to download. A string that starts with `ft-`.
@@ -732,7 +732,7 @@ class AsyncFineTuningResource(AsyncAPIResource):
         self,
         id: str,
         *,
-        force: bool,
+        force: bool | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -815,7 +815,7 @@ class AsyncFineTuningResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AsyncBinaryAPIResponse:
         """
-        Download a compressed fine-tuned model or checkpoint.
+        Receive a compressed fine-tuned model or checkpoint.
 
         Args:
           ft_id: Fine-tune ID to download. A string that starts with `ft-`.

together/resources/images.py

@@ -8,7 +8,7 @@ from typing_extensions import Literal
 import httpx
 
 from ..types import image_generate_params
-from .._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
+from .._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
 from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
@@ -64,6 +64,7 @@ class ImagesResource(SyncAPIResource):
         n: int | Omit = omit,
         negative_prompt: str | Omit = omit,
         output_format: Literal["jpeg", "png"] | Omit = omit,
+        reference_images: SequenceNotStr[str] | Omit = omit,
         response_format: Literal["base64", "url"] | Omit = omit,
         seed: int | Omit = omit,
         steps: int | Omit = omit,
@@ -105,6 +106,10 @@ class ImagesResource(SyncAPIResource):
           output_format: The format of the image response. Can be either be `jpeg` or `png`. Defaults to
               `jpeg`.
 
+          reference_images: An array of image URLs that guide the overall appearance and style of the
+              generated image. These reference images influence the visual characteristics
+              consistently across the generation.
+
           response_format: Format of the image response. Can be either a base64 string or a URL.
 
           seed: Seed used for generation. Can be used to reproduce image generations.
@@ -135,6 +140,7 @@ class ImagesResource(SyncAPIResource):
                     "n": n,
                     "negative_prompt": negative_prompt,
                     "output_format": output_format,
+                    "reference_images": reference_images,
                     "response_format": response_format,
                     "seed": seed,
                     "steps": steps,
@@ -189,6 +195,7 @@ class AsyncImagesResource(AsyncAPIResource):
         n: int | Omit = omit,
         negative_prompt: str | Omit = omit,
         output_format: Literal["jpeg", "png"] | Omit = omit,
+        reference_images: SequenceNotStr[str] | Omit = omit,
         response_format: Literal["base64", "url"] | Omit = omit,
         seed: int | Omit = omit,
         steps: int | Omit = omit,
@@ -230,6 +237,10 @@ class AsyncImagesResource(AsyncAPIResource):
           output_format: The format of the image response. Can be either be `jpeg` or `png`. Defaults to
               `jpeg`.
 
+          reference_images: An array of image URLs that guide the overall appearance and style of the
+              generated image. These reference images influence the visual characteristics
+              consistently across the generation.
+
           response_format: Format of the image response. Can be either a base64 string or a URL.
 
           seed: Seed used for generation. Can be used to reproduce image generations.
@@ -260,6 +271,7 @@ class AsyncImagesResource(AsyncAPIResource):
                     "n": n,
                     "negative_prompt": negative_prompt,
                     "output_format": output_format,
+                    "reference_images": reference_images,
                     "response_format": response_format,
                     "seed": seed,
                     "steps": steps,

together/resources/videos.py

@@ -20,7 +20,6 @@ from .._response import (
 )
 from .._base_client import make_request_options
 from ..types.video_job import VideoJob
-from ..types.video_create_response import VideoCreateResponse
 
 __all__ = ["VideosResource", "AsyncVideosResource"]
 
@@ -68,7 +67,7 @@ class VideosResource(SyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> VideoCreateResponse:
+    ) -> VideoJob:
         """
         Create a video
 
@@ -139,7 +138,7 @@ class VideosResource(SyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=VideoCreateResponse,
+            cast_to=VideoJob,
         )
 
     def retrieve(
@@ -219,7 +218,7 @@ class AsyncVideosResource(AsyncAPIResource):
         extra_query: Query | None = None,
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
-    ) -> VideoCreateResponse:
+    ) -> VideoJob:
         """
         Create a video
 
@@ -290,7 +289,7 @@ class AsyncVideosResource(AsyncAPIResource):
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
-            cast_to=VideoCreateResponse,
+            cast_to=VideoJob,
         )
 
     async def retrieve(

together/types/__init__.py

@@ -46,7 +46,6 @@ from .batch_create_response import BatchCreateResponse as BatchCreateResponse
 from .image_generate_params import ImageGenerateParams as ImageGenerateParams
 from .job_retrieve_response import JobRetrieveResponse as JobRetrieveResponse
 from .model_upload_response import ModelUploadResponse as ModelUploadResponse
-from .video_create_response import VideoCreateResponse as VideoCreateResponse
 from .endpoint_create_params import EndpointCreateParams as EndpointCreateParams
 from .endpoint_list_response import EndpointListResponse as EndpointListResponse
 from .endpoint_update_params import EndpointUpdateParams as EndpointUpdateParams

together/types/audio/transcription_create_params.py

@@ -34,6 +34,20 @@ class TranscriptionCreateParams(TypedDict, total=False):
     If `auto` is provided, language is auto-detected.
     """
 
+    max_speakers: int
+    """Maximum number of speakers expected in the audio.
+
+    Used to improve diarization accuracy when the approximate number of speakers is
+    known.
+    """
+
+    min_speakers: int
+    """Minimum number of speakers expected in the audio.
+
+    Used to improve diarization accuracy when the approximate number of speakers is
+    known.
+    """
+
     model: Literal["openai/whisper-large-v3"]
     """Model to use for transcription"""
 

together/types/fine_tuning_delete_params.py

@@ -2,10 +2,10 @@
 
 from __future__ import annotations
 
-from typing_extensions import Required, TypedDict
+from typing_extensions import TypedDict
 
 __all__ = ["FineTuningDeleteParams"]
 
 
 class FineTuningDeleteParams(TypedDict, total=False):
-    force: Required[bool]
+    force: bool

together/types/image_generate_params.py

@@ -5,6 +5,8 @@ from __future__ import annotations
 from typing import Union, Iterable
 from typing_extensions import Literal, Required, TypedDict
 
+from .._types import SequenceNotStr
+
 __all__ = ["ImageGenerateParams", "ImageLora"]
 
 
@@ -61,6 +63,13 @@ class ImageGenerateParams(TypedDict, total=False):
     Can be either be `jpeg` or `png`. Defaults to `jpeg`.
     """
 
+    reference_images: SequenceNotStr[str]
+    """
+    An array of image URLs that guide the overall appearance and style of the
+    generated image. These reference images influence the visual characteristics
+    consistently across the generation.
+    """
+
     response_format: Literal["base64", "url"]
     """Format of the image response. Can be either a base64 string or a URL."""
 

{together-2.0.0a7.dist-info → together-2.0.0a9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: together
-Version: 2.0.0a7
+Version: 2.0.0a9
 Summary: The official Python library for the together API
 Project-URL: Homepage, https://github.com/togethercomputer/together-py
 Project-URL: Repository, https://github.com/togethercomputer/together-py
@@ -144,6 +144,7 @@ pip install 'together[aiohttp] @ git+ssh://git@github.com/togethercomputer/toget
 Then you can enable it by instantiating the client with `http_client=DefaultAioHttpClient()`:
 
 ```python
+import os
 import asyncio
 from together import DefaultAioHttpClient
 from together import AsyncTogether
@@ -151,7 +152,7 @@ from together import AsyncTogether
 
 async def main() -> None:
     async with AsyncTogether(
-        api_key="My API Key",
+        api_key=os.environ.get("TOGETHER_API_KEY"),  # This is the default and can be omitted
         http_client=DefaultAioHttpClient(),
     ) as client:
         chat_completion = await client.chat.completions.create(
@@ -244,22 +245,6 @@ chat_completion = client.chat.completions.create(
 print(chat_completion.response_format)
 ```
 
-## File uploads
-
-Request parameters that correspond to file uploads can be passed as `bytes`, or a [`PathLike`](https://docs.python.org/3/library/os.html#os.PathLike) instance or a tuple of `(filename, contents, media type)`.
-
-```python
-from pathlib import Path
-from together import Together
-
-client = Together()
-
-client.files.upload(
-    file=Path("/path/to/file"),
-    purpose="fine-tune",
-)
-```
-
 The async client uses the exact same interface. If you pass a [`PathLike`](https://docs.python.org/3/library/os.html#os.PathLike) instance, the file contents will be read asynchronously automatically.
 
 ## Handling errors
@@ -528,40 +513,6 @@ with Together() as client:
 
 ## Usage – CLI
 
-### Chat Completions
-
-```bash
-together chat.completions \
-  --message "system" "You are a helpful assistant named Together" \
-  --message "user" "What is your name?" \
-  --model mistralai/Mixtral-8x7B-Instruct-v0.1
-```
-
-The Chat Completions CLI enables streaming tokens to stdout by default. To disable streaming, use `--no-stream`.
-
-### Completions
-
-```bash
-together completions \
-  "Large language models are " \
-  --model mistralai/Mixtral-8x7B-v0.1 \
-  --max-tokens 512 \
-  --stop "."
-```
-
-The Completions CLI enables streaming tokens to stdout by default. To disable streaming, use `--no-stream`.
-
-### Image Generations
-
-```bash
-together images generate \
-  "space robots" \
-  --model stabilityai/stable-diffusion-xl-base-1.0 \
-  --n 4
-```
-
-The image is opened in the default image viewer by default. To disable this, use `--no-show`.
-
 ### Files
 
 ```bash

{together-2.0.0a7.dist-info → together-2.0.0a9.dist-info}/RECORD

@@ -9,9 +9,9 @@ together/_models.py,sha256=3D65psj_C02Mw0K2zpBWrn1khmrvtEXgTTQ6P4r3tUY,31837
 together/_qs.py,sha256=craIKyvPktJ94cvf9zn8j8ekG9dWJzhWv0ob34lIOv4,4828
 together/_resource.py,sha256=-ZTq9O5qf2YsgjJk_gwJs-CM_OG4p6gdMLcNWjuxFwQ,1112
 together/_response.py,sha256=lvqEsCbpD8SRJTjlhhUFGbnLUR_4-Qva-OApxfVdiY4,28800
-together/_streaming.py,sha256=SgGfDGFD2J4pNdMrj--YjD8tCjfEj-htf_Jk6q1aby4,11625
+together/_streaming.py,sha256=sk6fVYbpdO3Y-0S5iwZTHQJ3N24UkK0KaupgUTftWZk,11825
 together/_types.py,sha256=nL3wDyii53Z400Anq1qLS1pEW0PwQId-OjnbRJDwoj4,7238
-together/_version.py,sha256=Ka0Gs567t27ygs2-oPANbfh_j61uZB-jYvgun8LTzTg,168
+together/_version.py,sha256=p3SWLX96_Ba9f7WpAgA4thdvwcM0aML58lmPvGUECTE,168
 together/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 together/_utils/__init__.py,sha256=7fch0GT9zpNnErbciSpUNa-SjTxxjY6kxHxKMOM4AGs,2305
 together/_utils/_compat.py,sha256=rN17SSvjMoQE1GmKFTLniRuG1sKj2WAD5VjdLPeRlF0,1231
@@ -24,14 +24,14 @@ together/_utils/_streams.py,sha256=SMC90diFFecpEg_zgDRVbdR3hSEIgVVij4taD-noMLM,2
 together/_utils/_sync.py,sha256=HBnZkkBnzxtwOZe0212C4EyoRvxhTVtTrLFDz2_xVCg,1589
 together/_utils/_transform.py,sha256=NjCzmnfqYrsAikUHQig6N9QfuTVbKipuP3ur9mcNF-E,15951
 together/_utils/_typing.py,sha256=N_5PPuFNsaygbtA_npZd98SVN1LQQvFTKL6bkWPBZGU,4786
-together/_utils/_utils.py,sha256=zaHjfH3uG2SSJUqIPCWRaTCkTBNm_1hw-P-ZV0XZHec,12320
+together/_utils/_utils.py,sha256=g9ftElB09kVT6EVfCIlD_nUfANhDX5_vZO61FDWoIQI,12334
 together/lib/.keep,sha256=wuNrz-5SXo3jJaJOJgz4vFHM41YH_g20F5cRQo0vLes,224
 together/lib/__init__.py,sha256=Qtdi6geFNzxE-F51eNDk1ESXYyYDt8b82MR1POANQBQ,394
 together/lib/constants.py,sha256=EgcTlmk4QqVqjZjGej5k5JEwoRqidlITQ8LQqzW0dXI,1795
 together/lib/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 together/lib/cli/cli.py,sha256=bNzYeLF8JdlMnSmIqFClp28MzjLGCwQ9hqSpaXHBQ0s,1939
 together/lib/cli/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-together/lib/cli/api/endpoints.py,sha256=4hUkoNwobyF4rNaXLB7Xkazp_yYAyp6ai2d68Xxly-o,14867
+together/lib/cli/api/endpoints.py,sha256=MyliUrTuJWw2qFd80J27pFs9xTazIVAP0mqgRYxdVsw,14851
 together/lib/cli/api/evals.py,sha256=KkSvz2wIYmPQ3sFQBte6inNBZt1aptIkMVL5TKWTW5k,19074
 together/lib/cli/api/files.py,sha256=HbflC45PpzBIF0CE0TLucQaVr319ScL05VyAFKf2T6Y,3596
 together/lib/cli/api/fine_tuning.py,sha256=yTkFpzgvcfhdvdocbG9ftWfs9SfeZj5jFHHmTO1MxTY,19909
@@ -43,7 +43,7 @@ together/lib/resources/fine_tuning.py,sha256=vQIcUKuDsl5XY5Qf9l5kwtuIFEB3L89K63c
 together/lib/resources/models.py,sha256=h3UZxMzz0Kq9Lzp3KaL0HLcUco1fqtwWanxPB16g_1g,1118
 together/lib/types/__init__.py,sha256=1-kHsAp9Sh9HxjTGKfdHnF1nTS_cM_Tazv-3Z9hrEbY,205
 together/lib/types/error.py,sha256=i-rnTZPRZuJDUf1lM-52abG2JHWOUBTCh55zPNGoakg,135
-together/lib/types/fine_tuning.py,sha256=_r6sVspzuxdLLaP7TLGknD13Nk5YmrMq3JtLEXCEdLw,11513
+together/lib/types/fine_tuning.py,sha256=DN8mTSna3ptO-gQJBy_MnAZ-Zw6jOwZNuA73eVBt5l8,12555
 together/lib/utils/__init__.py,sha256=F_CVqnvK-aEshMg-5FLFincPbhuVbsM6IKSCNyEByKs,545
 together/lib/utils/_log.py,sha256=mo5tDhyFTNqEj8MOcpy3bLmLBcC0OQ67orTw_nxFdcU,1930
 together/lib/utils/files.py,sha256=S6orZixBPeRtV_iq_IktuYHIm41irrHuOuexz_NYZJ0,24863
@@ -56,17 +56,17 @@ together/resources/embeddings.py,sha256=7EU6DZQd0Nm0Sh7x7v37QQOLNuLqNmcjdJAyOTck
 together/resources/endpoints.py,sha256=dYdLlAJ0P7HJNhzZGxlbzEQYpUWsh35cjAMVfdWiifw,27884
 together/resources/evals.py,sha256=FPjvkbsBY5rrzLyQ-X1G9fWt2QmivI9ol5GExGtqYVA,16216
 together/resources/files.py,sha256=0paHeVqNt3NQCXoztCgFS8PEIg_-mMVto-ulHTr7GzE,16854
-together/resources/fine_tuning.py,sha256=w0onlDx3rkrFuMxvWmGUNDor-GSRh1vPc7jWqhGQBsM,45289
+together/resources/fine_tuning.py,sha256=gjGJn1bAZlHHRGhjhfrZ7bNU1AgTtrQqSK4BshL47Hg,45315
 together/resources/hardware.py,sha256=xgfCmMrrwF5o1igax0JGec8RY7kkS0s4kKm62RdC3ME,6850
-together/resources/images.py,sha256=hRXxDtMl3oBeMq0dfkdyvu4Qi1YqB_dhFsan0wynUk8,11870
+together/resources/images.py,sha256=mVPQYpDHKBjLVO_Sv0uT62zYXdtWKN2PW3fCvfQLQCs,12612
 together/resources/jobs.py,sha256=TnzSnvJw4x5pqo1xzrkYH8f0viZrzyOqT-_w7xc0NzY,7797
 together/resources/models.py,sha256=kb4OeIFbyfzCE_4rO87i4AMlnuDoTa3pXqKKG95VoLo,10614
 together/resources/rerank.py,sha256=Xoaco2OvKdII7AhPaJDqUqoXmJvXbTWmY4_g_aqq8dQ,8334
-together/resources/videos.py,sha256=HCiCO58gZ75bMDWFqYPRdicoGkUsXJXjY0YycnDnT2c,14989
+together/resources/videos.py,sha256=AdcC08JrUtbcEJV-G0viH4CF1qU9oNjdjQ7U38QCEkU,14883
 together/resources/audio/__init__.py,sha256=MKUWFwFsAdCf9LrO8AiUCeIzdknPNDPr4lpAt-pkYSw,2521
 together/resources/audio/audio.py,sha256=stpvzuxIwMnAQLQnqW1KRxx3G_DI-oDSnx3uDN_X1R8,7180
 together/resources/audio/speech.py,sha256=ZavAHDhi8rKzIQ0tRTv1UOIlUJQ5_ArvH3JG1JdN41M,27560
-together/resources/audio/transcriptions.py,sha256=j_ySc6787yilePUVK-fb_NbCOydLAvsJ3JsM5pWS3L0,11913
+together/resources/audio/transcriptions.py,sha256=k5zLDKXNqISjeieSyi1FKbyKsWyhnkeIkApG3l7QzeY,12965
 together/resources/audio/translations.py,sha256=zeV1wJPGzBmQGGgSPNA_vigy_4yuV3aBq6sSLa19-jg,10251
 together/resources/audio/voices.py,sha256=Lj9DtOcv_Dhaq3E5p7Oty1T_JkhrsGDZcDF91HHA3Yw,4905
 together/resources/chat/__init__.py,sha256=BVAfz9TM3DT5W9f_mt0P9YRxL_MsUxKCWAH6u1iogmA,1041
@@ -75,7 +75,7 @@ together/resources/chat/completions.py,sha256=bgOO_1BBhVDMiTN3brn11Rt1BpDPmfHYrk
 together/resources/code_interpreter/__init__.py,sha256=qeNVuBUuYy66RDhyh4RDx_xsf0gTMIrrZkZHpkPy9r0,1146
 together/resources/code_interpreter/code_interpreter.py,sha256=ZrWQIn5FO-uau3qTt_HhsHiaclM_ZNfOqZI_AWT2SMk,10373
 together/resources/code_interpreter/sessions.py,sha256=Sl8X6-r1gds2VHhzpjPhfwYNTciZCJxAH-YjJerA_eU,5020
-together/types/__init__.py,sha256=inrKEzp0lOD0KXA0D7iLuA5vAFGAeyCPQaHskGRJVTU,4539
+together/types/__init__.py,sha256=hq3GuuB078PZuKe7BgP1CJCRAOlNO1fgi2O23YCFPEE,4461
 together/types/audio_speech_stream_chunk.py,sha256=npxlsMce0q4_VoJaZzfSh982TYTM0-j-zmhyI-9hP5o,346
 together/types/autoscaling.py,sha256=JipJZsNblLTE3XN5hglJy2KdffI1A2UGB5nIx6_imFQ,371
 together/types/autoscaling_param.py,sha256=rMCfBYYswaJIHTSsnnICtZ2barAbgbdzhaHDyAEav30,468
@@ -109,7 +109,7 @@ together/types/file_response.py,sha256=Abmu-Ph-masbhAFePB64VhiswHEFmExWF34jaiTm4
 together/types/file_type.py,sha256=lrvFtcJr0Wn5thWP4NihmrmK23AouK2e6Ev4LCCPg5A,218
 together/types/fine_tuning_cancel_response.py,sha256=aPZPl8nzBs5tGk1gq-Ah35_vzibCyaeJIq-iZi0g2XQ,5220
 together/types/fine_tuning_content_params.py,sha256=_5rqZ2lk6FShmX-5Hj4A9jQdpPZP6lcgjXvnrC30G8k,711
-together/types/fine_tuning_delete_params.py,sha256=Xs2UW6-h0M7TZ7uMPht6CP2z62iOwWo6QP0DPuzWe04,293
+together/types/fine_tuning_delete_params.py,sha256=YwUcN_gFl9N2zuUJqyOrE0ngONL2N_OgfVw6h-sH2RE,273
 together/types/fine_tuning_delete_response.py,sha256=oWoJM51-2b_RIINhJSMyMelSKQkHFYrJjDLeD51dUgo,323
 together/types/fine_tuning_list_checkpoints_response.py,sha256=9S0kRl7ItqFU6CeodrB9jb1zgf7-Ehb7VGjsbKq_hBY,377
 together/types/fine_tuning_list_events_response.py,sha256=DeDJLF1IxQV47HOwfuVt8Zis5W2CKs3iKkKvwDxyswk,309
@@ -122,7 +122,7 @@ together/types/hardware_list_response.py,sha256=cUhOyWYc_Z8-FRBHUgNgA3fI0XTfPgUq
 together/types/image_data_b64.py,sha256=pLY7JDBb1HF1T29ACbae_xn6JQfttpqQVeG_jJeenZU,284
 together/types/image_data_url.py,sha256=6A_EYNfcR6Z6sZkyC4MThxeZnK2cvTuQn6-A1dXM85w,274
 together/types/image_file.py,sha256=sADh0UcrGlemkreIvHBEBizstAvt64CVOu7KtOALcHk,569
-together/types/image_generate_params.py,sha256=siOZ7I-pVD61nx3nIwCw7HfMgK-u1SJkMMdUs-7Akkw,2488
+together/types/image_generate_params.py,sha256=bdOsD1NXYjCq8QT27wCd8P1hGWIfCd70E8u6n8TLzGQ,2783
 together/types/job_list_response.py,sha256=y7tFXGH2dYD9PfVH2_2Rf6RDkWsW4olljXt5FnGO6UA,950
 together/types/job_retrieve_response.py,sha256=I4HHmSUCAVFuy2RkrZuanssaPLRkDmG_i0Qc192yRmM,880
 together/types/log_probs.py,sha256=A1DD9Cdb5G7bufrBiaMZC4HJ7v1NH5_zFEYvLgFY1NI,473
@@ -138,11 +138,10 @@ together/types/tools_param.py,sha256=dRo4u37j5nyjhyU_yc2_l5smDOs76UhQluB-CMq8BMU
 together/types/training_method_dpo.py,sha256=INdq7tJYKBhY_Hwodn217h-9-7q4IX6mJdRN4P44vdQ,519
 together/types/training_method_sft.py,sha256=Ro9vRS2Kw9e5HENJ6BXLGZjqKsfTsrGLfoVljoOlHgw,453
 together/types/video_create_params.py,sha256=9Mx7TWTaPHOOpaMezz9FD5VC7hN6jGbnynGlUNPr8U0,2657
-together/types/video_create_response.py,sha256=OBrwAfRsPIdhkoNSk4pBunjWNkk-yAa9VhE-YzgVqO8,253
 together/types/video_job.py,sha256=E3YyxzPDXHv8aFjIqZ8NgokZbkVqOaNM5_ERQAjC6PE,1470
 together/types/audio/__init__.py,sha256=FRPjWqhXrrSZgg615cnF6cWNqEowSovw__2V7BR3kgo,654
 together/types/audio/speech_create_params.py,sha256=SwoTcRMG5NnO_LpT3eAXFfOqqxyFh6C-cU8mtY2v4lk,2867
-together/types/audio/transcription_create_params.py,sha256=pKjDwN2DUcJG3yVjfw-WmZ68PURwxojJqem3p_5-rJU,1788
+together/types/audio/transcription_create_params.py,sha256=utzevQa2y_fiznVYVIUK7J76HzH_YWgLsvtbtFIH_Gs,2156
 together/types/audio/transcription_create_response.py,sha256=z8_pzJlzYjP4QxJhwbKuDgAeVpWbgee6jt3QLFVVSjM,3059
 together/types/audio/translation_create_params.py,sha256=RjKaaR2RNSE4DxuBHCBKDURxxqalZJmApIhtmDV7MBM,1140
 together/types/audio/translation_create_response.py,sha256=T6SUCExVMin1qSGamHuiWGWS84MZ92tZPBHD7NYm4IU,1843
@@ -158,8 +157,8 @@ together/types/chat/chat_completion_warning.py,sha256=_Dp7YKlxyY2HeZopTvT-Go7qqK
 together/types/chat/completion_create_params.py,sha256=xPv9X0dtBuPt9wnDm7wlncgGjGZJGkK8P6sFIGhc6WY,10954
 together/types/code_interpreter/__init__.py,sha256=dAXfb3ryLMtcBalCfxxNu2wJVswVP8G1xXryZnahPQY,201
 together/types/code_interpreter/session_list_response.py,sha256=TRxLGFTmIY-KLpStKjJtsrm4EI6BBvakpx43B6pkhnw,662
-together-2.0.0a7.dist-info/METADATA,sha256=HzZyUH2AwPzifwR9EdqiKMNwK2a9ql8jDA-ZnSBCxFw,21442
-together-2.0.0a7.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
-together-2.0.0a7.dist-info/entry_points.txt,sha256=4f4RAX89wQkx3AnfHXiGrKyg2fCPnwMd2UdPX48OczA,55
-together-2.0.0a7.dist-info/licenses/LICENSE,sha256=5I5MO2DiiBFcD_p4ZF2T4GDb-WeBMD591ALtADdtXDc,11338
-together-2.0.0a7.dist-info/RECORD,,
+together-2.0.0a9.dist-info/METADATA,sha256=9tkQfrZfh5J-etaBCQFnsx7JIy6lCw8xAEsBfhr7F-M,20276
+together-2.0.0a9.dist-info/WHEEL,sha256=C2FUgwZgiLbznR-k0b_5k3Ai_1aASOXDss3lzCUsUug,87
+together-2.0.0a9.dist-info/entry_points.txt,sha256=4f4RAX89wQkx3AnfHXiGrKyg2fCPnwMd2UdPX48OczA,55
+together-2.0.0a9.dist-info/licenses/LICENSE,sha256=5I5MO2DiiBFcD_p4ZF2T4GDb-WeBMD591ALtADdtXDc,11338
+together-2.0.0a9.dist-info/RECORD,,

together/types/video_create_response.py

@@ -1,10 +0,0 @@
-# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-from .._models import BaseModel
-
-__all__ = ["VideoCreateResponse"]
-
-
-class VideoCreateResponse(BaseModel):
-    id: str
-    """Unique identifier for the video job."""