release: 0.31.0

[stainless-app]

Automated Release PR

0.31.0 (2025-12-01)

Full Changelog: v0.30.0...v0.31.0

⚠ BREAKING CHANGES

• api: Change call signature for audio.create to audio.speech.create to match spec with python library and add space for future APIs
• 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
• api: Access to the api for listing checkpoints has changed its name to list_checkpoints
• api: Access to fine tuning APIs namespace has changed from fine_tune to fine_tuning

Features

• api: Add audio.voices.list sdk (890595e)
• api: Add batches.cancel API (b1133f8)
• api: Add endpoints.list_avzones (606fea8)
• api: Add fine_tune.delete API (79d0c84)
• api: api update (fed5c48)
• api: api update (1022fa6)
• api: api update (da3e212)
• api: api update (4be10bc)
• api: api update (e594a76)
• api: api update (8ec7bf0)
• api: api update (04797be)
• api: api update (c219bfd)
• api: Change fine tuning download method to .create (34f7fe5)
• api: Change image creation signature to images.generate (250569f)
• api: Change rerank method signature (70a0ddc)
• api: Change TTS call signature (fd2189a)
• api: files.upload supported with custom file checks (5cba49f)
• api: Fix internal references for VideoJob spec (2ce325f)
• api: manual updates (9f78929)
• api: Update Eval APIs (c91b8c0)

Chores

• api: Cleanup some exported types (3b1eddb)
• api: Ensure file.upload API remains in codebase after stainless sync (68895c0)
• api: Remove API that is not intended to be public. (46dcc83)
• api: Remove auto-generated files upload API to support custom coded version (94c54cb)
• client: fix logger property type (10df0df)
• Fix API example (8f34c93)
• Fix fine tuning examples (b477053)
• fix lint and type checks (#201) (963673f)

Styles

• api: Change fine tuning method retrieve_checkpoints to list_checkpoints (b2c168a)
• api: Change fine tuning namespace to fine_tuning (77b1211)

---

This pull request is managed by Stainless's GitHub App.

The semver version number is based on included commit messages. Alternatively, you can manually set the version number in the title of this pull request.

For a better experience, it is recommended to use either rebase-merge or squash-merge when merging this pull request.

🔗 Stainless website
📚 Read the docs
🙋 Reach out for help or questions

---

Note

Renames several APIs (audio.speech, images.generate, fineTuning, rerank.create), adds voices listing, batch canceling, endpoint availability zones, revamped evals, and introduces first‑class files.upload with strict local validation.

• Breaking API Renames/Moves:
  • audio.create → audio.speech.create; introduces audio.speech and audio.voices.list.
  • images.create → images.generate.
  • Fine-tuning namespace fine_tune → fineTuning; download() → content(); retrieve_checkpoints → listCheckpoints.
  • Rerank moved to client.rerank.create() (from top-level).
• New/Updated Endpoints & Types:
  • Batches: add batches.cancel; retrieve returns BatchJob.
  • Endpoints: add listAvzones; unify types to DedicatedEndpoint; support availability_zone; list filters mine, usage_type.
  • Evals: new evals.create, evals.status; list path now /evaluation; types reworked.
  • Videos/Models: videos.create returns VideoJob; models list returns ModelObject.
• Files:
  • Add files.upload(file, purpose, check?) with custom preflight validation (src/lib/check-file.ts) supporting JSONL/CSV(eval)/Parquet checks.
• Docs/Examples/Tests:
  • Update README/api.md/examples to new signatures; add tests for audio.speech, audio.voices.list, batches.cancel, endpoints.listAvzones, files.upload, and updated evals.
• Release: bump to 0.31.0; prune unused deps; stats/spec hashes updated.

^{Written by Cursor Bugbot for commit 35465cf. This will update automatically on new commits. Configure here.}

[cursor]

This PR is being reviewed by Cursor Bugbot

Details

Your team is on the Bugbot Free tier. On this plan, Bugbot will review limited PRs each billing cycle for each member of your team.

To receive Bugbot reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.

[cursor]

Bug: User Input Overrides Required API Parameters

The delete method spreads options after setting the query property, allowing user-provided options.query to override the required force parameter. This means the force value from params could be lost if the caller passes query in options, breaking the API call.

 

[cursor]

Bug: API Inconsistency Prevents Reasoning in Chat Creation

The reasoning field is missing from CompletionCreateParams.ChatCompletionAssistantMessageParam but present in the top-level ChatCompletionAssistantMessageParam and in response types. This inconsistency prevents users from including reasoning in assistant messages when creating chat completions, even though the API supports it in responses.

src/resources/chat/completions.ts#L535-L548

together-typescript/src/resources/chat/completions.ts

Lines 535 to 548 in 0eb8879

	export interface ChatCompletionAssistantMessageParam {
	role: 'assistant';
	content?: string | null;
	/**
	* @deprecated
	*/
	function_call?: ChatCompletionAssistantMessageParam.FunctionCall;
	name?: string;
	tool_calls?: Array<CompletionsAPI.ToolChoice>;

 

---

[cursor]

Bug: Upload returns object instead of rejecting promise

When an invalid file type is provided, the code returns an object { message: '...' } instead of calling reject(). This causes the Promise to never settle, making the application hang indefinitely. Additionally, the reject() calls on lines 37 and 50 are missing return statements, so execution continues after rejection - the code will attempt to process the file even after the Promise was rejected, potentially causing unexpected behavior or errors.

Additional Locations (2)

• src/lib/upload.ts#L35-L38
• src/lib/upload.ts#L48-L51

 

[stainless-app]

🤖 Release is at https://github.com/togethercomputer/together-typescript/releases/tag/v0.31.0 🌻