Together Python SDK v2.0 Release Candidate with Jobs, Hardware, and Code Interpreter support
AI Impact Summary
Together AI is releasing the Python SDK v2.0 Release Candidate, a strongly typed OpenAPI-driven client that replaces v1.0 and adds first-class Jobs and Hardware APIs, plus Code Interpreter sessions. The RC window lasts about one month and may introduce small, documented breaking changes before GA, so teams should start integration testing to adapt to the new client surface (client.jobs.*, client.hardware.*, client.code_interpreter.sessions.*) and the revised error hierarchy (TogetherError with 400/401/429/5xx and specific errors). The update also introduces raw and streaming helpers for easier debugging and visibility during migration and enables richer type definitions across chat messages and eval parameters.
Together Python SDK v2.0 Release Candidate with Jobs, Hardware, and Code Interpreter support
Applications using the Together Python SDK must migrate to v2.0 during the RC window to access new features (Jobs, Hardware, Code Interpreter) and to align with the new error hierarchy before GA, or risk compatibility issues after the release.
Models affected
active
Together Python SDK v2.0
sdk
new
Jobs API
api
new
Hardware API
api
new
Together CLI v2.10
tool
new
Dedicated Container Inference
infrastructure
new
Together Deployments
infrastructure
Risk domains
792%
Source text
Together AI is releasing the Python SDK v2.0 Release Candidate , a new, OpenAPI-generated, strongly-typed client that replaces the legacy v1.0 package and brings the SDK into lock-step with the latest platform features.
Install: pip install together==2.0.0a9 . RC period: The v2.0 RC window starts today and will run for approximately one month. During this time we’ll iterate quickly based on developer feedback and may make a few small, well-documented breaking changes before GA. Type-safe, modern client: Stronger typing across parameters and responses, keyword-only arguments, explicit NOT_GIVEN handling for optional fields, and rich together.types.* definitions for chat messages, eval parameters, and more. Redesigned error model: Replaces TogetherException with a new TogetherError hierarchy, including APIStatusError and specific HTTP status code errors such as BadRequestError (400) , AuthenticationError (401) , RateLimitError (429) , and InternalServerError (5xx) , plus transport ( APIConnectionError , APITimeoutError ) and validation ( APIResponseValidationError ) errors. New Jobs API: Adds first-class support for the Jobs API ( client.jobs.* ) so you can create, list, and inspect asynchronous jobs directly from the SDK without custom HTTP wrappers. New Hardware API: Adds the Hardware API ( client.hardware.* ) to discover available hardware, filter by model compatibility, and compute effective hourly pricing from cents_per_minute . Raw response and streaming helpers: New .with_raw_response and .with_streaming_response helpers make it easier to debug, inspect headers and status codes, and stream completions via context managers with automatic cleanup. Code Interpreter sessions: Adds session management for the Code Interpreter ( client.code_interpreter.sessions.* ), enabling multi-step, stateful code-execution workflows that were not possible in the legacy SDK. High compatibility for core APIs: Most core usage patterns, including chat.completions , completions , embed