mistralai-client-rs/CHANGELOG.md

Changelog

1.0.0 (2026-03-20)

Forked from ivangabriele/mistralai-client-rs v0.14.0 and updated to the latest Mistral AI API.

⚠ BREAKING CHANGES

• Model is now a string-based struct with constructor methods instead of a closed enum
• EmbedModel is removed — use Model::mistral_embed() instead
• Tool::new() parameters now accept serde_json::Value (JSON Schema) instead of limited enum types
• ChatParams.temperature is now Option<f32> instead of f32
• Stream delta content is now Option<String>

Features

• Add all current Mistral models (Large 3, Small 4, Medium 3.1, Magistral, Codestral, Devstral, Pixtral, Voxtral, Ministral)
• Add FIM (fill-in-the-middle) completions endpoint
• Add Files API (upload, list, get, delete, download URL)
• Add Fine-tuning jobs API (create, list, get, cancel, start)
• Add Batch jobs API (create, list, get, cancel)
• Add OCR endpoint (document text extraction)
• Add Audio transcription endpoint
• Add Moderations and Classifications endpoints
• Add Agent completions endpoint
• Add new chat fields: frequency_penalty, presence_penalty, stop, n, min_tokens, parallel_tool_calls, reasoning_effort, json_schema response format
• Add embedding fields: output_dimension, output_dtype
• Add tool call IDs and Required tool choice variant
• Add model get and delete endpoints

---

Upstream Changelog (pre-fork)

0.14.0 (2024-08-27)

Features

• constants: update model constants (#17) (161b33c)

0.13.0 (2024-08-21)

⚠ BREAKING CHANGES

• client: v1::model_list::ModelListData struct has been updated.

Bug Fixes

• client: remove the Content-Type from the headers of the reqwest builders. (#14) (9bfbf2e), closes #13
• client: update ModelListData struct following API changes (2114916)

0.12.0 (2024-07-24)

Features

• implement the Debug trait for Client (#11) (3afeec1)
• mark Function trait as Send (#12) (8e9f7a5)

0.11.0 (2024-06-22)

Features

• constants: add OpenMixtral8x22b, MistralTiny & CodestralLatest to Model enum (ecd0c30)

Bug Fixes

• chat: implement Clone trait for ChatParams & ResponseFormat (0df67b1)

0.10.0 (2024-06-07)

⚠ BREAKING CHANGES

• chat: - Chat::ChatParams.safe_prompt & Chat::ChatRequest.safe_prompt are now bool instead of Option<bool>. Default is false.

• Chat::ChatParams.temperature & Chat::ChatRequest.temperature are now f32 instead of Option<f32>. Default is 0.7.
• Chat::ChatParams.top_p & Chat::ChatRequest.top_p are now f32 instead of Option<f32>. Default is 1.0.

Features

• chat: add response_format for JSON return values (85c3611)
• chat: add the 'system' and 'tool' message roles (#10) (2fc0642)
• chat: change safe_prompt, temperature & top_p to non-Option types (cf68a77)

Bug Fixes

• chat: skip serializing tool_calls if null, to avoid 422 error (da5fe54)

0.9.0 (2024-04-13)

⚠ BREAKING CHANGES

• Model.OpenMistral8x7b has been renamed to Model.OpenMixtral8x7b.

Bug Fixes

• deps: update rust crate reqwest to 0.12.0 (#6) (fccd59c)
• fix typo in OpenMixtral8x7b model name (#8) (6a99eca)

0.8.0 (2024-03-09)

⚠ BREAKING CHANGES

• Too many to count in this version. Check the README examples.

Features

• add function calling support to client.chat() & client.chat_async() (74bf8a9)

0.7.0 (2024-03-05)

⚠ BREAKING CHANGES

• • Rename ClientError.ApiKeyError to MissingApiKey.

• Rename ClientError.ReadResponseTextError to ClientError.UnreadableResponseText.

Bug Fixes

• fix failure when api key as param and not env (ef5d475)

0.6.0 (2024-03-04)

⚠ BREAKING CHANGES

• You can't set the stream option for client.chat*().

Either use client.chat_stream() if you want to use streams or use client.chat() / client.chat_async() otherwise.

Features

• add client.chat_stream() method (4a4219d)

0.5.0 (2024-03-04)

Features

• add client.embeddings_async() method (3c22891)
• add client.list_models_async() method (b69f7c6)

0.4.0 (2024-03-04)

⚠ BREAKING CHANGES

• Client::new() now returns a Result.
• APIError is renamed to ApiError.

Features

• add client.chat_async() method (1dd59f6)
• add missing api key error (1deab88)
• wrap Client::new() return in a Result (3387618)

0.3.0 (2024-03-04)

⚠ BREAKING CHANGES

• Models are now enforced by Model & EmbedModel enums.

Features

• add client.embeddings() method (f44d951)

0.2.0 (2024-03-03)

⚠ BREAKING CHANGES

• Chat completions must now be called directly from client.chat() without building a request in between.

Features

• add client.list_models() method (814b991)
• simplify chat completion call (7de2b19)

0.1.0 (2024-03-03)

Features

• add chat completion without streaming (7d3b438)