release: 0.1.0-alpha.12 (#148)

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0-alpha.11"
+  ".": "0.1.0-alpha.12"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 30
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/togetherai%2Ftogetherai-48f3206278cd93af20d7d74aed1fd8e1513a04a60468505a40b0a15fbdab31a3.yml
-openapi_spec_hash: 69c1236ff3815089881984840aa4d3f6
-config_hash: f39be209cf332e8d80f34099b178970a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/togetherai%2Ftogetherai-653a4aa26fdd2b335d1ead9c2ea0672cbe48a7616b76bf350a2421a8def4e08d.yml
+openapi_spec_hash: 1d5af8ab9d8c11d7f5225e19ebd1654a
+config_hash: d15dd709dd3f87b0a8b83b00b4abc881

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.0-alpha.12 (2025-06-10)
+
+Full Changelog: [v0.1.0-alpha.11...v0.1.0-alpha.12](https://github.com/togethercomputer/together-py/compare/v0.1.0-alpha.11...v0.1.0-alpha.12)
+
+### Features
+
+* **api:** address diagnostic issues in audio api, correct openapi issue in images api, disambiguate a response in finetune api, enable automated testing on finetune and images ([9d72038](https://github.com/togethercomputer/together-py/commit/9d7203895723e9be3600fa970430d33b51049094))
+
 ## 0.1.0-alpha.11 (2025-06-03)
 
 Full Changelog: [v0.1.0-alpha.10...v0.1.0-alpha.11](https://github.com/togethercomputer/together-py/compare/v0.1.0-alpha.10...v0.1.0-alpha.11)

api.md

@@ -85,12 +85,20 @@ Types:
 
 ```python
 from together.types import (
+    CosineLrSchedulerArgs,
     FineTune,
     FineTuneEvent,
+    FullTrainingType,
+    LinearLrSchedulerArgs,
+    LoRaTrainingType,
+    LrScheduler,
+    TrainingMethodDpo,
+    TrainingMethodSft,
     FineTuneCreateResponse,
     FineTuneListResponse,
     FineTuneCancelResponse,
     FineTuneDownloadResponse,
+    FineTuneListEventsResponse,
     FineTuneRetrieveCheckpointsResponse,
 )
 ```
@@ -102,7 +110,7 @@ Methods:
 - <code title="get /fine-tunes">client.fine_tune.<a href="./src/together/resources/fine_tune.py">list</a>() -> <a href="./src/together/types/fine_tune_list_response.py">FineTuneListResponse</a></code>
 - <code title="post /fine-tunes/{id}/cancel">client.fine_tune.<a href="./src/together/resources/fine_tune.py">cancel</a>(id) -> <a href="./src/together/types/fine_tune_cancel_response.py">FineTuneCancelResponse</a></code>
 - <code title="get /finetune/download">client.fine_tune.<a href="./src/together/resources/fine_tune.py">download</a>(\*\*<a href="src/together/types/fine_tune_download_params.py">params</a>) -> <a href="./src/together/types/fine_tune_download_response.py">FineTuneDownloadResponse</a></code>
-- <code title="get /fine-tunes/{id}/events">client.fine_tune.<a href="./src/together/resources/fine_tune.py">list_events</a>(id) -> <a href="./src/together/types/fine_tune_event.py">FineTuneEvent</a></code>
+- <code title="get /fine-tunes/{id}/events">client.fine_tune.<a href="./src/together/resources/fine_tune.py">list_events</a>(id) -> <a href="./src/together/types/fine_tune_list_events_response.py">FineTuneListEventsResponse</a></code>
 - <code title="get /fine-tunes/{id}/checkpoints">client.fine_tune.<a href="./src/together/resources/fine_tune.py">retrieve_checkpoints</a>(id) -> <a href="./src/together/types/fine_tune_retrieve_checkpoints_response.py">FineTuneRetrieveCheckpointsResponse</a></code>
 
 # CodeInterpreter
@@ -134,7 +142,7 @@ Methods:
 Types:
 
 ```python
-from together.types import ImageFile
+from together.types import ImageDataB64, ImageDataURL, ImageFile
 ```
 
 Methods:
@@ -146,7 +154,7 @@ Methods:
 Types:
 
 ```python
-from together.types import AudioFile
+from together.types import AudioFile, AudioSpeechStreamChunk
 ```
 
 Methods:
@@ -185,6 +193,7 @@ Types:
 
 ```python
 from together.types import (
+    Autoscaling,
     EndpointCreateResponse,
     EndpointRetrieveResponse,
     EndpointUpdateResponse,

examples/image.py

@@ -1,6 +1,7 @@
 import base64
 
 from together import Together
+from together.types.image_data_b64 import ImageDataB64
 
 client = Together(api_key="04cf1e314be9c686cd14b3881f5c4ad76505af4c93a8d3fe6ef62337114d1d51")
 
@@ -11,7 +12,7 @@
 )
 
 # Write the image to a file
-if image.data and image.data[0] and image.data[0].b64_json:
+if image.data and image.data[0] and isinstance(image.data[0], ImageDataB64):
     image_data = image.data[0].b64_json
 
     binary_data = base64.b64decode(image_data)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "together"
-version = "0.1.0-alpha.11"
+version = "0.1.0-alpha.12"
 description = "The official Python library for the together API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/together/_version.py

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

src/together/lib/cli/api/images.py

@@ -5,6 +5,7 @@
 from PIL import Image
 
 from together import Together
+from together.types.image_data_b64 import ImageDataB64
 
 
 @click.group()
@@ -63,7 +64,7 @@ def generate(
     )
 
     for i, choice in enumerate(response.data):
-        if choice.b64_json:
+        if isinstance(choice, ImageDataB64):
             with open(f"{output}/{prefix}{choice.index}.png", "wb") as f:
                 f.write(base64.b64decode(choice.b64_json))
 

src/together/lib/resources/fine_tune.py

@@ -6,18 +6,14 @@
 from ..types.fine_tune import (
     FinetuneTrainingLimits,
 )
-from ...types.fine_tune_create_params import (
-    LrScheduler,
-    TrainingType,
-    TrainingMethod,
-    FineTuneCreateParams,
-    TrainingTypeFullTrainingType,
-    TrainingTypeLoRaTrainingType,
-    TrainingMethodTrainingMethodDpo,
-    TrainingMethodTrainingMethodSft,
-    LrSchedulerLrSchedulerArgsCosineLrSchedulerArgs,
-    LrSchedulerLrSchedulerArgsLinearLrSchedulerArgs,
-)
+from ...types.lr_scheduler_param import LrSchedulerParam
+from ...types.fine_tune_create_params import TrainingType, TrainingMethod, FineTuneCreateParams
+from ...types.full_training_type_param import FullTrainingTypeParam
+from ...types.lo_ra_training_type_param import LoRaTrainingTypeParam
+from ...types.training_method_dpo_param import TrainingMethodDpoParam
+from ...types.training_method_sft_param import TrainingMethodSftParam
+from ...types.cosine_lr_scheduler_args_param import CosineLrSchedulerArgsParam
+from ...types.linear_lr_scheduler_args_param import LinearLrSchedulerArgsParam
 
 AVAILABLE_TRAINING_METHODS = {
     "sft",
@@ -71,7 +67,7 @@ def create_finetune_request(
     if warmup_ratio is None:
         warmup_ratio = 0.0
 
-    training_type: TrainingType = TrainingTypeFullTrainingType(type="Full")
+    training_type: TrainingType = FullTrainingTypeParam(type="Full")
     max_batch_size: int = 0
     max_batch_size_dpo: int = 0
     min_batch_size: int = 0
@@ -80,7 +76,7 @@ def create_finetune_request(
             raise ValueError(f"LoRA adapters are not supported for the selected model ({model_or_checkpoint}).")
         lora_r = lora_r if lora_r is not None else model_limits.lora_training.max_rank
         lora_alpha = lora_alpha if lora_alpha is not None else lora_r * 2
-        training_type = TrainingTypeLoRaTrainingType(
+        training_type = LoRaTrainingTypeParam(
             type="Lora",
             lora_r=lora_r,
             lora_alpha=lora_alpha,
@@ -146,29 +142,29 @@ def create_finetune_request(
     if dpo_beta is not None and training_method != "dpo":
         raise ValueError("dpo_beta is only supported for DPO training")
 
-    lr_scheduler: LrScheduler
+    lr_scheduler: LrSchedulerParam
     if lr_scheduler_type == "cosine":
         if scheduler_num_cycles <= 0.0:
             raise ValueError(f"Number of cycles should be greater than 0 (got {scheduler_num_cycles})")
 
-        lr_scheduler = LrScheduler(
+        lr_scheduler = LrSchedulerParam(
             lr_scheduler_type="cosine",
-            lr_scheduler_args=LrSchedulerLrSchedulerArgsCosineLrSchedulerArgs(
+            lr_scheduler_args=CosineLrSchedulerArgsParam(
                 min_lr_ratio=min_lr_ratio,  # type: ignore
                 num_cycles=scheduler_num_cycles,
             ),
         )
     else:
-        lr_scheduler = LrScheduler(
+        lr_scheduler = LrSchedulerParam(
             lr_scheduler_type="linear",
-            lr_scheduler_args=LrSchedulerLrSchedulerArgsLinearLrSchedulerArgs(min_lr_ratio=min_lr_ratio),  # type: ignore
+            lr_scheduler_args=LinearLrSchedulerArgsParam(min_lr_ratio=min_lr_ratio),  # type: ignore
         )
 
     training_method_cls: TrainingMethod
     if training_method == "sft":
-        training_method_cls = TrainingMethodTrainingMethodSft(method="sft", train_on_inputs=train_on_inputs)  # type: ignore
+        training_method_cls = TrainingMethodSftParam(method="sft", train_on_inputs=train_on_inputs)  # type: ignore
     elif training_method == "dpo":
-        training_method_cls = TrainingMethodTrainingMethodDpo(method="dpo", dpo_beta=dpo_beta)  # type: ignore
+        training_method_cls = TrainingMethodDpoParam(method="dpo", dpo_beta=dpo_beta)  # type: ignore
 
     finetune_request = FineTuneCreateParams(
         model=model,  # type: ignore