diff --git a/modules/ROOT/pages/tinymceai-models.adoc b/modules/ROOT/pages/tinymceai-models.adoc index 4e831e8f9f..1706a89445 100644 --- a/modules/ROOT/pages/tinymceai-models.adoc +++ b/modules/ROOT/pages/tinymceai-models.adoc @@ -21,179 +21,207 @@ The `agent-1` model automatically selects the best AI model for requests based o [[supported-models-table]] === Supported Models -The following is a detailed list of available models with their capabilities: +The following is a detailed list of available models with their capabilities. In the *Status* column, ✓ marks an active model and ⚠ marks a deprecated model, with its removal date. -[cols="1,2,1,1,2"] +[cols="1,2,1,1,2,1"] |=== -|Model |Description |xref:tinymceai-chat.adoc#web-search[Web Search] |xref:tinymceai-chat.adoc#reasoning[Reasoning] |Configuration id +|Model |Description |xref:tinymceai-chat.adoc#web-search[Web Search] |xref:tinymceai-chat.adoc#reasoning[Reasoning] |Configuration id |Status |**Auto (default)** |Automatically selects best model for speed, quality, and cost. |Yes |Yes |`'auto'` (also `'agent-1'`, learn more about xref:tinymceai-models.adoc#model-compatibility-versions[compatibility versions]) +|✓ |**GPT-5.6 Sol** |OpenAI's frontier model for complex professional work and advanced reasoning |Yes |Yes |`'gpt-5.6-sol'` +|✓ |**GPT-5.6 Terra** |Balances intelligence, speed, and cost for everyday tasks |Yes |Yes |`'gpt-5.6-terra'` +|✓ |**GPT-5.6 Luna** |OpenAI's most cost-efficient GPT-5.6 model for high-volume tasks |Yes |Yes |`'gpt-5.6-luna'` +|✓ |**GPT-5.5** |OpenAI's flagship model for advanced reasoning, creativity, and complex tasks |Yes |Yes |`'gpt-5.5'` +|✓ |**GPT-5.4** |OpenAI's flagship model for advanced reasoning, creativity, and complex tasks |Yes |Yes |`'gpt-5.4'` +|✓ |**GPT-5.2** |OpenAI's flagship model for advanced reasoning, creativity, and complex tasks |Yes |Yes |`'gpt-5.2'` +|✓ |**GPT-5.1** |OpenAI's flagship model for advanced reasoning, creativity, and complex tasks |Yes |Yes |`'gpt-5.1'` +|✓ |**GPT-5** |OpenAI's flagship model for advanced reasoning, creativity, and complex tasks |Yes |Yes |`'gpt-5'` +|✓ |**GPT-4.1** |OpenAI's model for reliable reasoning, speed, and versatility |Yes |No |`'gpt-4.1'` +|✓ |**GPT-5 Mini** |A lightweight version of GPT-5 for faster, more cost-efficient responses |Yes |Yes |`'gpt-5-mini'` +|✓ |**GPT-5.4 Mini** |A lighter variant of GPT-5.4 that balances speed and cost while maintaining solid accuracy |Yes |Yes |`'gpt-5.4-mini'` +|✓ |**GPT-4.1 Mini** |A lighter variant of GPT-4.1 that balances speed and cost while maintaining solid accuracy |Yes |No |`'gpt-4.1-mini'` +|✓ |**Claude Opus 4.8** |Anthropic's most capable model for extended reasoning and complex tasks |Yes |Yes |`'claude-opus-4-8'` +|✓ |**Claude Opus 5** |Anthropic's most capable model for extended reasoning and complex tasks |Yes |Yes |`'claude-opus-5'` +|✓ |**Claude Fable 5** |Anthropic's most capable model for extended reasoning and complex tasks |Yes |Yes |`'claude-fable-5'` +|✓ |**Claude Opus 4.7** |Anthropic's most capable model for extended reasoning and complex tasks |Yes |Yes |`'claude-opus-4-7'` +|✓ |**Claude 5 Sonnet** |Advanced model with improved creativity, reliability, and reasoning |Yes |Yes |`'claude-5-sonnet'` +|✓ |**Claude 4.6 Sonnet** |Advanced model with improved creativity, reliability, and reasoning |Yes |Yes |`'claude-4-6-sonnet'` +|✓ |**Claude 4.5 Sonnet** |Advanced model with improved creativity, reliability, and reasoning |Yes |Yes |`'claude-4-5-sonnet'` +|⚠ xref:tinymceai-models.adoc#model-deprecation[Removal on October 30, 2026] |**Claude 4.5 Haiku** |Cost-efficient model for quick interactions with improved reasoning |Yes |Yes |`'claude-4-5-haiku'` +|✓ |**Gemini 3.1 Pro** |Google's advanced model for versatile problem-solving and research |Yes |Yes |`'gemini-3-1-pro'` +|✓ |**Gemini 2.5 Flash** |Lightweight Gemini model for fast, cost-efficient interactions |Yes |Yes |`'gemini-2-5-flash'` +|✓ |**Gemini 3 Flash** |Lightweight Gemini model for fast, cost-efficient interactions |Yes |Yes |`'gemini-3-flash'` +|✓ |**Gemini 3.5 Flash** |Lightweight Gemini model for fast, cost-efficient interactions |Yes |Yes |`'gemini-3-5-flash'` +|✓ |**Gemini 3.6 Flash** |Lightweight Gemini model for fast, cost-efficient interactions |Yes |Yes |`'gemini-3-6-flash'` +|✓ |**Gemini 3.7 Flash** |Lightweight Gemini model for fast, cost-efficient interactions |Yes |Yes |`'gemini-3-7-flash'` +|✓ |**Gemini 3.8 Flash** |Lightweight Gemini model for fast, cost-efficient interactions |Yes |Yes |`'gemini-3-8-flash'` +|✓ |=== [[limitations]] @@ -345,6 +373,22 @@ If the application requires translated model descriptions (the text returned by Models scheduled for removal will include a `removal` field with an ISO 8601 date (for example, `"removal": "2025-11-17T00:00:00.000Z"`). When a model is removed, API requests will fail with error code `MODEL_NOT_FOUND` and the models endpoint will stop returning that particular model. +Models scheduled for removal are marked with ⚠ and their removal date in the *Status* column of the xref:tinymceai-models.adoc#supported-models-table[Supported Models] table. + +[IMPORTANT] +==== +After the removal date, features that name a removed model stop working. The result depends on where the model is set: + +* The `model` option of xref:tinymceai-actions.adoc#custom-actions[custom Quick Actions] or xref:tinymceai.adoc#integrator-defined-reviews[integrator-defined reviews], or the `model` field of API requests: the model ID is sent unchanged, and every request fails with error code `MODEL_NOT_FOUND`. +* xref:tinymceai.adoc#tinymceai_default_model[`+tinymceai_default_model+`]: the removed model is no longer in the list of available models, so {pluginname} uses the first available model instead and logs a warning to the browser console. + +Built-in Quick Actions and built-in reviews do not set a model and are not affected. +==== + +Before the removal date, switch each of these settings to another model from the xref:tinymceai-models.adoc#supported-models-table[Supported Models] table, or to `'auto'`. + +To check for deprecated models programmatically, read the model list from `GET /v1/models/\{version}`. Each model scheduled for removal includes its `removal` date, and the same list can be used to choose a replacement model. See xref:tinymceai-models.adoc#model-information[Model Information] for an example request. + [[api-examples]] == API Examples