release: 0.31.0

[stainless-app]

Automated Release PR

0.31.0 (2025-11-26)

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)
• 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

[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>;

 

---