release: 2.0.0-alpha.1 (#175)

* chore(api): Remove auto-generated fine_tuning.create method from Python SDK

* feat(api): Change image creation signature to `images.generate`

BREAKING CHANGE: For the TS SDK the `images.create` is now `images.generate`

* feat(api): Change fine tuning download method to `.create`

BREAKING CHANGE: Change Fine Tuning method name from `download()` to `content()` to align with other namespaces

* feat(api): api update

* feat(api): Change rerank method signature

BREAKING CHANGE: Update method signature for reranking to `rerank.create()`

* feat(api): Port finetuning create code from together-python (#176)

* chore: Fix examples

* release: 2.0.0-alpha.1

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>
Co-authored-by: Blaine Kasten <[email protected]>

Author: stainless-app[bot]

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0-alpha.28"
+  ".": "2.0.0-alpha.1"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 45
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/togetherai%2Ftogetherai-57c68db188c5a4e69e16f99e7e4968f08f2dbf64e7e7d8f57f54f84669305189.yml
-openapi_spec_hash: 4e707463a416fd079a6beeff1d1beecb
-config_hash: 566058c6cddd3fb076ade46bc5e78274
+configured_endpoints: 44
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/togetherai%2Ftogetherai-b86f8e6c4674d1a7829ffa8ddff4bc93d21334d231e6a4d0fd734d411c07a4eb.yml
+openapi_spec_hash: 8af4975be6ae8f4655fa92fd26af9682
+config_hash: b337cdd3c62dbd3383529592a029b347

CHANGELOG.md

@@ -1,5 +1,29 @@
 # Changelog
 
+## 2.0.0-alpha.1 (2025-11-21)
+
+Full Changelog: [v0.1.0-alpha.28...v2.0.0-alpha.1](https://github.com/togethercomputer/together-py/compare/v0.1.0-alpha.28...v2.0.0-alpha.1)
+
+### ⚠ BREAKING CHANGES
+
+* **api:** Update method signature for reranking to `rerank.create()`
+* **api:** Change Fine Tuning method name from `download()` to `content()` to align with other namespaces
+* **api:** For the TS SDK the `images.create` is now `images.generate`
+
+### Features
+
+* **api:** api update ([921fa59](https://github.com/togethercomputer/together-py/commit/921fa591a5a9c70f96d457a7b59749dfdfb6d4d6))
+* **api:** Change fine tuning download method to `.create` ([aa27907](https://github.com/togethercomputer/together-py/commit/aa279076c524956e204cb68b7424048a4f93a17d))
+* **api:** Change image creation signature to `images.generate` ([a6e3ad7](https://github.com/togethercomputer/together-py/commit/a6e3ad792393be978b123c87707afe779ef8df34))
+* **api:** Change rerank method signature ([338c415](https://github.com/togethercomputer/together-py/commit/338c415d1cee04520413717ee821f47a64316211))
+* **api:** Port finetuning create code from together-python ([#176](https://github.com/togethercomputer/together-py/issues/176)) ([ef3bd52](https://github.com/togethercomputer/together-py/commit/ef3bd5245ee254269653ff8e6db1651cfcf89c6d))
+
+
+### Chores
+
+* **api:** Remove auto-generated fine_tuning.create method from Python SDK ([c533f29](https://github.com/togethercomputer/together-py/commit/c533f29e2b94d5d9ca97ed50c181dae0fc2dcd7b))
+* Fix examples ([35422cb](https://github.com/togethercomputer/together-py/commit/35422cb1eef730a04117d83c8df08442461f5ec1))
+
 ## 0.1.0-alpha.28 (2025-11-18)
 
 Full Changelog: [v0.1.0-alpha.27...v0.1.0-alpha.28](https://github.com/togethercomputer/together-py/compare/v0.1.0-alpha.27...v0.1.0-alpha.28)

api.md

@@ -1,15 +1,3 @@
-# Together
-
-Types:
-
-```python
-from together.types import RerankResponse
-```
-
-Methods:
-
-- <code title="post /rerank">client.<a href="./src/together/_client.py">rerank</a>(\*\*<a href="src/together/types/client_rerank_params.py">params</a>) -> <a href="./src/together/types/rerank_response.py">RerankResponse</a></code>
-
 # Chat
 
 ## Completions
@@ -93,7 +81,6 @@ from together.types import (
     LrScheduler,
     TrainingMethodDpo,
     TrainingMethodSft,
-    FineTuningCreateResponse,
     FineTuningListResponse,
     FineTuningDeleteResponse,
     FineTuningCancelResponse,
@@ -104,12 +91,11 @@ from together.types import (
 
 Methods:
 
-- <code title="post /fine-tunes">client.fine_tuning.<a href="./src/together/resources/fine_tuning.py">create</a>(\*\*<a href="src/together/types/fine_tuning_create_params.py">params</a>) -> <a href="./src/together/types/fine_tuning_create_response.py">FineTuningCreateResponse</a></code>
 - <code title="get /fine-tunes/{id}">client.fine_tuning.<a href="./src/together/resources/fine_tuning.py">retrieve</a>(id) -> <a href="./src/together/types/fine_tune.py">FineTune</a></code>
 - <code title="get /fine-tunes">client.fine_tuning.<a href="./src/together/resources/fine_tuning.py">list</a>() -> <a href="./src/together/types/fine_tuning_list_response.py">FineTuningListResponse</a></code>
 - <code title="delete /fine-tunes/{id}">client.fine_tuning.<a href="./src/together/resources/fine_tuning.py">delete</a>(id, \*\*<a href="src/together/types/fine_tuning_delete_params.py">params</a>) -> <a href="./src/together/types/fine_tuning_delete_response.py">FineTuningDeleteResponse</a></code>
 - <code title="post /fine-tunes/{id}/cancel">client.fine_tuning.<a href="./src/together/resources/fine_tuning.py">cancel</a>(id) -> <a href="./src/together/types/fine_tuning_cancel_response.py">FineTuningCancelResponse</a></code>
-- <code title="get /finetune/download">client.fine_tuning.<a href="./src/together/resources/fine_tuning.py">download</a>(\*\*<a href="src/together/types/fine_tuning_download_params.py">params</a>) -> BinaryAPIResponse</code>
+- <code title="get /finetune/download">client.fine_tuning.<a href="./src/together/resources/fine_tuning.py">content</a>(\*\*<a href="src/together/types/fine_tuning_content_params.py">params</a>) -> BinaryAPIResponse</code>
 - <code title="get /fine-tunes/{id}/checkpoints">client.fine_tuning.<a href="./src/together/resources/fine_tuning.py">list_checkpoints</a>(id) -> <a href="./src/together/types/fine_tuning_list_checkpoints_response.py">FineTuningListCheckpointsResponse</a></code>
 - <code title="get /fine-tunes/{id}/events">client.fine_tuning.<a href="./src/together/resources/fine_tuning.py">list_events</a>(id) -> <a href="./src/together/types/fine_tuning_list_events_response.py">FineTuningListEventsResponse</a></code>
 
@@ -147,7 +133,7 @@ from together.types import ImageDataB64, ImageDataURL, ImageFile
 
 Methods:
 
-- <code title="post /images/generations">client.images.<a href="./src/together/resources/images.py">create</a>(\*\*<a href="src/together/types/image_create_params.py">params</a>) -> <a href="./src/together/types/image_file.py">ImageFile</a></code>
+- <code title="post /images/generations">client.images.<a href="./src/together/resources/images.py">generate</a>(\*\*<a href="src/together/types/image_generate_params.py">params</a>) -> <a href="./src/together/types/image_file.py">ImageFile</a></code>
 
 # Videos
 
@@ -270,6 +256,18 @@ Methods:
 
 - <code title="get /hardware">client.hardware.<a href="./src/together/resources/hardware.py">list</a>(\*\*<a href="src/together/types/hardware_list_params.py">params</a>) -> <a href="./src/together/types/hardware_list_response.py">HardwareListResponse</a></code>
 
+# Rerank
+
+Types:
+
+```python
+from together.types import RerankCreateResponse
+```
+
+Methods:
+
+- <code title="post /rerank">client.rerank.<a href="./src/together/resources/rerank.py">create</a>(\*\*<a href="src/together/types/rerank_create_params.py">params</a>) -> <a href="./src/together/types/rerank_create_response.py">RerankCreateResponse</a></code>
+
 # Batches
 
 Types:

examples/fine_tuning.py

@@ -26,5 +26,5 @@
     print(e)
 
 # download the model
-downloaded = client.fine_tuning.download(ft_id=fine_tune_id)
+downloaded = client.fine_tuning.content(ft_id=fine_tune_id)
 print(downloaded)

examples/image.py

@@ -5,7 +5,7 @@
 
 client = Together(api_key="04cf1e314be9c686cd14b3881f5c4ad76505af4c93a8d3fe6ef62337114d1d51")
 
-image = client.images.create(
+image = client.images.generate(
     model="runwayml/stable-diffusion-v1-5",
     prompt="space robots",
     n=1,

pyproject.toml

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