You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/capabilities/reasoning.md
+31-5Lines changed: 31 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,11 +26,11 @@ Currently we have two reasoning models:
26
26
-`magistral-medium-latest`: Our more powerful reasoning model balancing performance and cost.
27
27
28
28
:::info
29
-
Currently, `-latest` points to `-2507`, our most recent version of our reasoning models. If you were previously using `-2506`, a **migration** regarding the thinking chunks is required.
30
-
-`-2507`**(new)**: Uses tokenized thinking chunks via control tokens, providing the thinking traces in different types of content chunks.
29
+
Currently, `-latest` points to `-2509`, our most recent version of our reasoning models. If you were previously using `-2506`, a **migration** regarding the thinking chunks is required.
30
+
-`-2507`& `-2509`**(new)**: Uses tokenized thinking chunks via control tokens, providing the thinking traces in different types of content chunks.
31
31
-`-2506`**(old)**: Used `<think>\n` and `\n</think>\n` tags as strings to encapsulate the thinking traces for input and output within the same content type.
@@ -109,7 +109,33 @@ To have the best performance out of our models, we recommend having the followin
109
109
<summary><b>System Prompt</b></summary>
110
110
111
111
<TabsgroupId="version">
112
-
<TabItemvalue="2507"label="2507 (new)"default>
112
+
<TabItemvalue="2509"label="2509 (new)"default>
113
+
```json
114
+
{
115
+
"role": "system",
116
+
"content": [
117
+
{
118
+
"type": "text",
119
+
"text": "# HOW YOU SHOULD THINK AND ANSWER\n\nFirst draft your thinking process (inner monologue) until you arrive at a response. Format your response using Markdown, and use LaTeX for any mathematical equations. Write both your thoughts and the response in the same language as the input.\n\nYour thinking process must follow the template below:"
120
+
},
121
+
{
122
+
"type": "thinking",
123
+
"thinking": [
124
+
{
125
+
"type": "text",
126
+
"text": "Your thoughts or/and draft, like working through an exercise on scratch paper. Be as casual and as long as you want until you are confident to generate the response to the user."
127
+
}
128
+
]
129
+
},
130
+
{
131
+
"type": "text",
132
+
"text": "Here, provide a self-contained response."
The output of the model will include different chunks of content, but mostly a `thinking` type with the reasoning traces and a `text` type with the answer like so:
Copy file name to clipboardExpand all lines: docs/capabilities/vision.md
+4-2Lines changed: 4 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,10 +11,12 @@ Vision capabilities enable models to analyze images and provide insights based o
11
11
For more specific use cases regarding document parsing and data extraction we recommend taking a look at our Document AI stack [here](../document_ai/document_ai_overview).
12
12
13
13
## Models with Vision Capabilities:
14
+
- Mistral Medium 3.1 2508 (`mistral-medium-latest`)
15
+
- Mistral Small 3.2 2506 (`mistral-small-latest`)
16
+
- Magistral Small 1.2 2509 (`magistral-small-latest`)
17
+
- Magistral Medium 1.2 2509 (`magistral-medium-latest`)
14
18
- Pixtral 12B (`pixtral-12b-latest`)
15
19
- Pixtral Large 2411 (`pixtral-large-latest`)
16
-
- Mistral Medium 2505 (`mistral-medium-latest`)
17
-
- Mistral Small 2503 (`mistral-small-latest`)
18
20
19
21
## Passing an Image URL
20
22
If the image is hosted online, you can simply provide the URL of the image in the request. This method is straightforward and does not require any encoding.
| Mistral Medium 3.1 ||:heavy_check_mark:| Our frontier-class multimodal model released August 2025. Improving tone and performance. Read more about Medium 3 in our [blog post](https://mistral.ai/news/mistral-medium-3/)| 128k |`mistral-medium-2508`| 25.08|
20
-
| Magistral Medium 1.1||:heavy_check_mark:| Our frontier-class reasoning model released July 2025. |40k|`magistral-medium-2507`| 25.07|
20
+
| Magistral Medium 1.2||:heavy_check_mark:| Our frontier-class reasoning model update released September 2025 with vision support. |128k|`magistral-medium-2509`| 25.09|
21
21
| Codestral 2508 ||:heavy_check_mark:| Our cutting-edge language model for coding released end of July 2025, Codestral specializes in low-latency, high-frequency tasks such as fill-in-the-middle (FIM), code correction and test generation. Learn more in our [blog post](https://mistral.ai/news/codestral-25-08/)| 256k |`codestral-2508`| 25.08|
22
22
| Voxtral Mini Transcribe ||:heavy_check_mark:| An efficient audio input model, fine-tuned and optimized for transcription purposes only. ||`voxtral-mini-2507` via `audio/transcriptions`| 25.07|
23
23
| Devstral Medium ||:heavy_check_mark:| An enterprise grade text model, that excels at using tools to explore codebases, editing multiple files and power software engineering agents. Learn more in our [blog post](https://mistral.ai/news/devstral-2507)| 128k |`devstral-medium-2507`| 25.07|
24
24
| Mistral OCR 2505 ||:heavy_check_mark:| Our OCR service powering our Document AI stack that enables our users to extract interleaved text and images ||`mistral-ocr-2505`| 25.05|
25
25
| Magistral Medium 1 ||:heavy_check_mark:| Our first frontier-class reasoning model released June 2025. Learn more in our [blog post](https://mistral.ai/news/magistral/)| 40k |`magistral-medium-2506`| 25.06|
26
26
| Ministral 3B ||:heavy_check_mark:| World’s best edge model. Learn more in our [blog post](https://mistral.ai/news/ministraux/)| 128k |`ministral-3b-2410`| 24.10|
27
27
| Ministral 8B |:heavy_check_mark: <br/> [Mistral Research License](https://mistral.ai/licenses/MRL-0.1.md)|:heavy_check_mark:|Powerful edge model with extremely high performance/price ratio. Learn more in our [blog post](https://mistral.ai/news/ministraux/)| 128k |`ministral-8b-2410`| 24.10|
28
+
| Magistral Medium 1.1 ||:heavy_check_mark:| Our frontier-class reasoning model released July 2025. | 40k |`magistral-medium-2507`| 25.07|
29
+
| Magistral Medium 1.0 ||:heavy_check_mark:| Our frontier-class reasoning model released June 2025. Learn more in our [blog post](https://mistral.ai/news/magistral/)| 40k |`magistral-medium-2506`| 25.06|
28
30
| Mistral Medium 3 ||:heavy_check_mark:| Our frontier-class multimodal model released May 2025. Learn more in our [blog post](https://mistral.ai/news/mistral-medium-3/)| 128k |`mistral-medium-2505`| 25.05|
29
31
| Codestral 2501 ||:heavy_check_mark:| Our cutting-edge language model for coding with the second version released January 2025, Codestral specializes in low-latency, high-frequency tasks such as fill-in-the-middle (FIM), code correction and test generation. Learn more in our [blog post](https://mistral.ai/news/codestral-2501/)| 256k |`codestral-2501`| 25.01|
30
32
| Mistral Large 2.1 |:heavy_check_mark: <br/> [Mistral Research License](https://mistral.ai/licenses/MRL-0.1.md)|:heavy_check_mark:| Our top-tier large model for high-complexity tasks with the lastest version released November 2024. Learn more in our [blog post](https://mistral.ai/news/pixtral-large/)| 128k |`mistral-large-2411`| 24.11|
@@ -38,6 +40,7 @@ Mistral provides two types of models: open models and premier models.
38
40
39
41
| Model | Weight availability|Available via API| Description | Max Tokens| API Endpoints|Version|
| Magistral Small 1.2 |:heavy_check_mark: <br/> Apache2 |:heavy_check_mark:| Our small reasoning model released September 2025 with vision support. | 128k |`magistral-small-2509`| 25.09|
41
44
| Magistral Small 1.1 |:heavy_check_mark: <br/> Apache2 |:heavy_check_mark:| Our small reasoning model released July 2025. | 40k |`magistral-small-2507`| 25.07|
42
45
| Voxtral Small |:heavy_check_mark: <br/> Apache2 |:heavy_check_mark:| Our first model with audio input capabilities for instruct use cases. | 32k |`voxtral-small-2507`| 25.07|
43
46
| Voxtral Mini |:heavy_check_mark: <br/> Apache2 |:heavy_check_mark:| A mini version of our first audio input model. | 32k |`voxtral-mini-2507`| 25.07|
@@ -58,8 +61,8 @@ it is recommended to use the dated versions of the Mistral AI API.
58
61
Additionally, be prepared for the deprecation of certain endpoints in the coming months.
59
62
60
63
Here are the details of the available versions:
61
-
-`magistral-medium-latest`: currently points to `magistral-medium-2507`.
62
-
-`magistral-small-latest`: currently points to `magistral-small-2507`.
64
+
-`magistral-medium-latest`: currently points to `magistral-medium-2509`.
65
+
-`magistral-small-latest`: currently points to `magistral-small-2509`.
63
66
-`mistral-medium-latest`: currently points to `mistral-medium-2508`.
64
67
-`mistral-large-latest`: currently points to `mistral-medium-2508`, previously `mistral-large-2411`.
65
68
-`pixtral-large-latest`: currently points to `pixtral-large-2411`.
0 commit comments