fix(types): constrain endpoint parameter to literals in batches

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 75
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/togetherai/togetherai-b584185aba41e3d597bf715d9b704f1c7d2663ae7d8f3f3c35e63d603738ee9c.yml
-openapi_spec_hash: 0b26ddf285392dd9f629c1161db62376
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/togetherai/togetherai-72e377e4d7f3fe8bb9f0dab1a70d7d9cf0f44914ff4d9b8ab238bc7f48008621.yml
+openapi_spec_hash: 798c6d992a5cb83901b5879502c22f9d
 config_hash: 6c214c91fad5ead4849be777fd9e8108

src/together/resources/batches.py

@@ -2,6 +2,8 @@
 
 from __future__ import annotations
 
+from typing_extensions import Literal
+
 import httpx
 
 from ..types import batch_create_params
@@ -46,7 +48,7 @@ def with_streaming_response(self) -> BatchesResourceWithStreamingResponse:
     def create(
         self,
         *,
-        endpoint: str,
+        endpoint: Literal["/v1/chat/completions", "/v1/audio/transcriptions", "/v1/audio/translations"],
         input_file_id: str,
         completion_window: str | Omit = omit,
         model_id: str | Omit = omit,
@@ -62,7 +64,13 @@ def create(
         Create a new batch job with the given input file and endpoint
 
         Args:
-          endpoint: The endpoint to use for batch processing
+          endpoint: The endpoint to use for batch processing. Each line of the uploaded input file
+              is dispatched against this endpoint.
+
+              - `/v1/chat/completions` — chat completion batches
+              - `/v1/audio/transcriptions` — audio transcription batches (e.g.
+                `openai/whisper-large-v3`)
+              - `/v1/audio/translations` — audio translation batches
 
           input_file_id: ID of the uploaded input file containing batch requests
 
@@ -211,7 +219,7 @@ def with_streaming_response(self) -> AsyncBatchesResourceWithStreamingResponse:
     async def create(
         self,
         *,
-        endpoint: str,
+        endpoint: Literal["/v1/chat/completions", "/v1/audio/transcriptions", "/v1/audio/translations"],
         input_file_id: str,
         completion_window: str | Omit = omit,
         model_id: str | Omit = omit,
@@ -227,7 +235,13 @@ async def create(
         Create a new batch job with the given input file and endpoint
 
         Args:
-          endpoint: The endpoint to use for batch processing
+          endpoint: The endpoint to use for batch processing. Each line of the uploaded input file
+              is dispatched against this endpoint.
+
+              - `/v1/chat/completions` — chat completion batches
+              - `/v1/audio/transcriptions` — audio transcription batches (e.g.
+                `openai/whisper-large-v3`)
+              - `/v1/audio/translations` — audio translation batches
 
           input_file_id: ID of the uploaded input file containing batch requests
 

src/together/types/batch_create_params.py

@@ -2,14 +2,22 @@
 
 from __future__ import annotations
 
-from typing_extensions import Required, TypedDict
+from typing_extensions import Literal, Required, TypedDict
 
 __all__ = ["BatchCreateParams"]
 
 
 class BatchCreateParams(TypedDict, total=False):
-    endpoint: Required[str]
-    """The endpoint to use for batch processing"""
+    endpoint: Required[Literal["/v1/chat/completions", "/v1/audio/transcriptions", "/v1/audio/translations"]]
+    """The endpoint to use for batch processing.
+
+    Each line of the uploaded input file is dispatched against this endpoint.
+
+    - `/v1/chat/completions` — chat completion batches
+    - `/v1/audio/transcriptions` — audio transcription batches (e.g.
+      `openai/whisper-large-v3`)
+    - `/v1/audio/translations` — audio translation batches
+    """
 
     input_file_id: Required[str]
     """ID of the uploaded input file containing batch requests"""