@mate-academy/llm-gateway 6.2.0 → 6.3.0

package/README.md

@@ -621,7 +621,7 @@ const customGPT5Model = {
   config: {
     ...gpt5Model.config,
     temperature: 1,  // Note: GPT-5 only supports temperature=1
-    reasoning_effort: 'high',  // 'minimal' | 'medium' | 'high'
+    reasoning_effort: 'high',  // 'minimal' | 'low' | 'medium' | 'high' | 'xhigh'
     verbosity: 'low',  // 'low' | 'medium' | 'high'
   }
 };
@@ -634,26 +634,26 @@ const customGPT51Model = {
   config: {
     ...gpt51Model.config,
     temperature: 1,  // Note: GPT-5.1 only supports temperature=1
-    reasoning_effort: 'none',  // 'none' | 'minimal' | 'medium' | 'high'
+    reasoning_effort: 'none',  // 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh'
     verbosity: 'low',  // 'low' | 'medium' | 'high'
   }
 };
 ```
 
-**Note:** All GPT-5 models require `temperature: 1` and cannot be changed. GPT-5, GPT-5-MINI, and GPT-5-NANO support reasoning_effort values of 'minimal', 'medium', or 'high'. GPT-5.1 and GPT-5.2 additionally supports 'none' as a reasoning_effort value.
+**Note:** All GPT-5 models require `temperature: 1` and cannot be changed. GPT-5, GPT-5-MINI, and GPT-5-NANO support reasoning_effort values of 'minimal', 'low', 'medium', 'high', or 'xhigh'. GPT-5.1, GPT-5.2, and GPT-5.4 additionally support 'none'.
 
-**Gemini 3 Pro Preview** has special configuration options:
+**Gemini 3.x thinking models** (gemini-3-flash-preview, gemini-3-pro-preview, gemini-3.1-pro-preview) have special configuration options:
 
 ```typescript
 import { ThinkingLevel } from '@google/genai';
 
-const gemini3Model = models[GoogleGenerativeAIModelNames.GEMINI_3_PRO_PREVIEW];
+const gemini31Model = models[GoogleGenerativeAIModelNames.GEMINI_3_1_PRO_PREVIEW];
 
-const customGemini3Model = {
-  ...gemini3Model,
+const customGemini31Model = {
+  ...gemini31Model,
   config: {
-    ...gemini3Model.config,
-    temperature: 1,  // Note: Gemini 3 Pro Preview only supports temperature=1
+    ...gemini31Model.config,
+    temperature: 1,  // Note: Gemini 3.x thinking models only support temperature=1
     thinkingConfig: {
       thinkingLevel: ThinkingLevel.HIGH,  // LOW | HIGH | THINKING_LEVEL_UNSPECIFIED
     },
@@ -661,7 +661,7 @@ const customGemini3Model = {
 };
 ```
 
-**Note:** Gemini 3 Pro Preview requires `temperature: 1` and cannot be changed. The `thinkingConfig` allows you to control the model's reasoning depth.
+**Note:** Gemini 3.x thinking models require `temperature: 1` and cannot be changed. The `thinkingConfig` allows you to control the model's reasoning depth.
 
 #### File-based Assistance
 
@@ -1311,9 +1311,11 @@ Supports all service types: completion, assistance, speech-to-text, and text-to-
 |-------|---------|-----------|------------|-------|
 | gpt-4.1 | Completion, Assistance | 1M+ | 32K | Extended context window |
 | gpt-4.1-mini | Completion, Assistance | 1M+ | 32K | Cost-effective extended context |
+| gpt-4.1-nano | Completion, Assistance | 1M+ | 32K | Fastest, most cost-efficient GPT-4.1 |
 | gpt-5 | Completion, Assistance | 400K | 128K | Advanced reasoning, requires temperature=1 |
 | gpt-5.1 | Completion, Assistance | 400K | 128K | Advanced reasoning with 'none' reasoning_effort support, requires temperature=1 |
 | gpt-5.2 | Completion, Assistance | 400K | 128K | Advanced reasoning with 'none' reasoning_effort support, requires temperature=1 |
+| gpt-5.4 | Completion, Assistance | 1M+ | 128K | Flagship model, supports 'none'/'xhigh' reasoning_effort, requires temperature=1 |
 | gpt-5-mini | Completion, Assistance | 400K | 128K | Smaller GPT-5 variant, requires temperature=1 |
 | gpt-5-nano | Completion, Assistance | 400K | 128K | Fastest GPT-5 variant, requires temperature=1 |
 | gpt-4o-transcribe | Speech-to-Text | 16K | 2K | Optimized for transcription |
@@ -1332,13 +1334,17 @@ Supports completion, assistance, speech-to-text, and text-to-speech APIs through
 | gemini-2.5-flash | Completion, Assistance, Speech-to-Text | 1M+ | 65K | Fast, cost-effective, supports caching for long context |
 | gemini-2.5-flash-lite | Completion, Assistance, Speech-to-Text | 1M+ | 65K | Fastest, most cost-effective, supports caching |
 | gemini-2.5-pro | Completion, Assistance, Speech-to-Text | 1M+ | 65K | Advanced reasoning, supports caching for long context |
-| gemini-3-pro-preview | Completion, Assistance, Speech-to-Text | 1M+ | 65K | Advanced reasoning with thinking capabilities, requires temperature=1, supports configurable thinking levels |
+| gemini-3-flash-preview | Completion, Assistance, Speech-to-Text | 1M+ | 65K | Thinking model, requires temperature=1, configurable thinking levels |
+| gemini-3.1-flash-lite-preview | Completion, Assistance, Speech-to-Text | 1M+ | 65K | Most cost-efficient Gemini 3.x model |
+| gemini-3-pro-preview | Completion, Assistance, Speech-to-Text | 1M+ | 65K | **Deprecated** (shutdown March 9, 2026). Migrate to gemini-3.1-pro-preview |
+| gemini-3.1-pro-preview | Completion, Assistance, Speech-to-Text | 1M+ | 65K | Advanced reasoning with thinking capabilities, requires temperature=1 |
 | gemini-2.5-flash-preview-tts | Text-to-Speech | 8K | 16K | Preview TTS model with flash performance |
 | gemini-2.5-pro-preview-tts | Text-to-Speech | 8K | 16K | Preview TTS model with pro capabilities |
 
 **Note:** Google Generative AI models support context caching for content longer than 32,768 tokens, which can significantly reduce costs for repeated queries on the same large context.
 
-**Gemini 3 Pro Preview Configuration:**
+**Gemini 3.x Thinking Model Configuration:**
+- Applies to: gemini-3-pro-preview, gemini-3-flash-preview, gemini-3.1-pro-preview
 - Requires `temperature: 1` (cannot be changed)
 - Supports `thinkingConfig` with `thinkingLevel` property (LOW, HIGH, THINKING_LEVEL_UNSPECIFIED)
 - Default thinking level is LOW