fix(docs): correct model capability field names and web-search examples

v3/data-governance/eu-endpoint.mdx

@@ -139,7 +139,12 @@ Each model entry carries a `regions` array so you can see at a glance which regi
   "object": "model",
   "owned_by": "mistral",
   "regions": [{ "code": "eu", "name": "Europe" }],
-  "capabilities": { "pdf": true, "reasoning": false, "web_search": false, "tool_calling": true }
+  "capabilities": {
+    "input_modalities": ["text", "image", "file"],
+    "supports_reasoning": false,
+    "supports_web_search": false,
+    "supports_function_calling": true
+  }
 }
 ```
 

v3/llms/listing-models.mdx

@@ -1,54 +1,50 @@
 ---
 title: "List LLM Models"
 icon: "list"
-description: "Use the /v3/models endpoint to retrieve all LLM models available through Eden AI, along with their capabilities: PDF support, reasoning, web search, and tool calling."
+description: "Use the /v3/models endpoint to retrieve all LLM models available through Eden AI, along with their capabilities: input modalities, reasoning, web search, and function calling."
 ---
 import { TechArticleSchema } from "/snippets/TechArticleSchema.mdx";
 
 <TechArticleSchema
   title={"List LLM Models"}
-  description={"Use the /v3/models endpoint to retrieve all LLM models available through Eden AI, along with their capabilities: PDF support, reasoning, web search, and tool calling."}
+  description={"Use the /v3/models endpoint to retrieve all LLM models available through Eden AI, along with their capabilities: input modalities, reasoning, web search, and function calling."}
   path="v3/llms/listing-models"
   articleSection="LLMs"
   about={"LLM API"}
   proficiencyLevel="Intermediate"
   keywords={["Eden AI", "AI API", "LLM API", "chat completion", "OpenAI compatible"]}
   datePublished="2026-05-06T00:00:00Z"
-  dateModified="2026-06-19T00:00:00Z"
+  dateModified="2026-07-28T00:00:00Z"
 />
 
-Use the `/v3/models` endpoint to retrieve all LLM models available through Eden AI, along with their capabilities: PDF support, reasoning, web search, and tool calling.
+Use the `/v3/models` endpoint to retrieve all LLM models available through Eden AI, along with their capabilities: input modalities, reasoning, web search, and function calling.
 
 ## Endpoint
 
 ```
 GET /v3/models
 ```
 
+The endpoint is public: no API key is required.
+
 ## Example
 
 <CodeGroup>
 ```bash cURL
-curl https://api.edenai.run/v3/models \
-  -H "Authorization: Bearer YOUR_API_KEY"
+curl https://api.edenai.run/v3/models
 ```
 
 ```python Python
 import requests
 
-response = requests.get(
-    "https://api.edenai.run/v3/models",
-    headers={"Authorization": "Bearer YOUR_API_KEY"}
-)
+response = requests.get("https://api.edenai.run/v3/models")
 
 for model in response.json()["data"]:
     print(model["id"])
 ```
 
 ```javascript JavaScript
-const response = await fetch("https://api.edenai.run/v3/models", {
-  headers: { "Authorization": "Bearer YOUR_API_KEY" }
-});
+const response = await fetch("https://api.edenai.run/v3/models");
 
 const { data } = await response.json();
 data.forEach(model => console.log(model.id));
@@ -57,42 +53,46 @@
 
 ## Response
 
+Each entry includes the model's identity, context window, capabilities, pricing, and available regions (list truncated for readability):
+
 ```json
 {
   "object": "list",
   "data": [
     {
-      "id": "openai/gpt-4o",
-      "object": "model",
-      "owned_by": "openai",
-      "capabilities": {
-        "pdf": true,
-        "reasoning": false,
-        "web_search": true,
-        "tool_calling": true
-      }
-    },
-    {
-      "id": "anthropic/claude-3-5-sonnet-latest",
-      "object": "model",
-      "owned_by": "anthropic",
-      "capabilities": {
-        "pdf": true,
-        "reasoning": false,
-        "web_search": false,
-        "tool_calling": true
-      }
-    },
-    {
-      "id": "anthropic/claude-3-7-sonnet-latest",
+      "id": "google/gemini-flash-latest",
       "object": "model",
-      "owned_by": "anthropic",
+      "created": 1784646733,
+      "owned_by": "google",
+      "model_name": "gemini-3.6-flash",
+      "context_length": 1048576,
+      "description": "Gemini 3.6 Flash is a high-efficiency model from Google...",
       "capabilities": {
-        "pdf": true,
-        "reasoning": true,
-        "web_search": false,
-        "tool_calling": true
-      }
+        "input_modalities": ["text", "image", "video", "file", "audio"],
+        "output_modalities": ["text"],
+        "supports_reasoning": true,
+        "supports_web_search": true,
+        "supports_tool_choice": true,
+        "supports_computer_use": false,
+        "supports_prompt_caching": true,
+        "supports_response_schema": true,
+        "supports_system_messages": true,
+        "supports_function_calling": true,
+        "supports_native_streaming": true,
+        "supports_assistant_prefill": false,
+        "supports_embedding_image_input": false,
+        "supports_parallel_function_calling": true
+      },
+      "pricing": {
+        "input_cost_per_token": 1.5e-06,
+        "output_cost_per_token": 7.5e-06,
+        "cache_read_input_token_cost": 1.5e-07,
+        "cache_creation_input_token_cost": 8.33e-08
+      },
+      "regions": [
+        { "code": "eu", "name": "Europe" }
+      ],
+      "alias_of": "google/gemini-3.6-flash"
     }
   ]
 }
@@ -102,12 +102,12 @@
 
 ## Model aliases
 
-Some models are available under a **stable alias** — a version-agnostic name that always points to the current release — alongside dated snapshot IDs:
+Some models are available under a **stable alias**, a version-agnostic name that always points to the current release, alongside versioned or dated snapshot IDs:
 
-- **Stable alias:** `deepseek/deepseek-chat`, `deepseek/deepseek-reasoner`
-- **Dated snapshot:** `anthropic/claude-opus-4-5-20251101`
+- **Stable alias:** `google/gemini-flash-latest`, `anthropic/claude-sonnet-latest`, `deepseek/deepseek-chat`
+- **Versioned snapshot:** `anthropic/claude-opus-4-5-20251101`
 
-Use the **stable alias** when you want your integration to keep working as providers ship new versions. **Pin a dated snapshot** when you need a fixed, reproducible model. Either form works as the `model` parameter.
+Use the **stable alias** when you want your integration to keep working as providers ship new versions. **Pin a versioned snapshot** when you need a fixed, reproducible model. Either form works as the `model` parameter. Alias entries report the concrete model they currently resolve to in the `alias_of` field, as in the response example above.
 
 The catalog lists both forms when a provider exposes them, so you may see a stable alias (e.g. `anthropic/claude-opus-4-5`) and one or more dated snapshots (e.g. `anthropic/claude-opus-4-5-20251101`) side by side. Use the stable alias to always get the latest version, or a dated snapshot to pin to a specific release.
 
@@ -117,10 +117,22 @@
 
 | Field | Description |
 |-------|-------------|
-| `pdf` | Model can process PDF files as input |
-| `reasoning` | Model supports extended thinking / reasoning mode |
-| `web_search` | Model can perform live web searches |
-| `tool_calling` | Model supports function/tool calling |
+| `input_modalities` | Input types the model accepts: `text`, `image`, `audio`, `video`, `file` |
+| `output_modalities` | Output types the model produces |
+| `supports_reasoning` | Model supports extended thinking / reasoning mode |
+| `supports_web_search` | Model can perform live web searches via [`web_search_options`](/v3/llms/web-search) |
+| `supports_function_calling` | Model supports function/tool calling |
+| `supports_tool_choice` | Model supports the `tool_choice` parameter |
+| `supports_prompt_caching` | Model supports prompt caching |
+| `supports_response_schema` | Model supports structured output with a response schema |
+| `supports_system_messages` | Model accepts system messages |
+| `supports_computer_use` | Model supports computer-use tooling |
+| `supports_parallel_function_calling` | Model can call multiple tools in one turn |
+| `supports_assistant_prefill` | Model accepts a pre-filled assistant message |
+| `supports_native_streaming` | Model supports native streaming responses |
+| `supports_embedding_image_input` | Model accepts image input for embeddings |
+
+Some models expose extra provider-specific keys (e.g. `supports_pdf_input`, `supports_audio_input`), and a few return `"capabilities": null`. Treat a missing key or a `null` object as "not supported".
 
 <Tip>
 You can also browse all features and providers visually in the [Eden AI model catalog](https://app.edenai.run/models).

v3/llms/web-search.mdx

@@ -1,7 +1,7 @@
 ---
 icon: "magnifying-glass"
 title: "Web Search"
 description: "Web search lets LLMs access real-time information from the internet when generating responses."
 ---
 import { TechArticleSchema } from "/snippets/TechArticleSchema.mdx";
 
@@ -14,10 +14,10 @@
   proficiencyLevel="Intermediate"
   keywords={["Eden AI", "AI API", "LLM API", "chat completion", "OpenAI compatible"]}
   datePublished="2026-05-06T00:00:00Z"
-  dateModified="2026-05-07T00:00:00Z"
+  dateModified="2026-07-28T00:00:00Z"
 />
 
 Web search lets LLMs access real-time information from the internet when generating responses. Instead of relying solely on training data, the model can search the web to ground its answers with up-to-date facts, links, and sources.
 
 ## How It Works
 
@@ -40,11 +40,11 @@
 }
 
 payload = {
-    "model": "openai/gpt-5.2",
+    "model": "google/gemini-flash-latest",
     "messages": [
         {"role": "user", "content": "What are the latest developments in AI regulation in 2025?"}
     ],
     "web_search_options": {
         "search_context_size": "medium"
     }
 }
@@ -62,7 +62,7 @@
 };
 
 const payload = {
-  model: 'openai/gpt-4o',
+  model: 'google/gemini-flash-latest',
   messages: [
     { role: 'user', content: 'What are the latest developments in AI regulation in 2025?' }
   ],
@@ -86,7 +86,7 @@
   -H "Authorization: Bearer YOUR_API_KEY" \
   -H "Content-Type: application/json" \
   -d '{
-    "model": "openai/gpt-4o",
+    "model": "google/gemini-flash-latest",
     "messages": [
       {"role": "user", "content": "What are the latest developments in AI regulation in 2025?"}
     ],
@@ -99,7 +99,30 @@
 
 ## Supported Models
 
-Not all models support web search. Use the [List LLM Models](/v3/llms/listing-models) endpoint to find models where `capabilities.web_search` is `true`.
+Not all models support web search. Use the [List LLM Models](/v3/llms/listing-models) endpoint to find models where `capabilities.supports_web_search` is `true`:
+
+<CodeGroup>
+```python Python
+import requests
+
+response = requests.get("https://api.edenai.run/v3/models")
+
+web_search_models = [
+    model["id"]
+    for model in response.json()["data"]
+    if (model.get("capabilities") or {}).get("supports_web_search")
+]
+print(web_search_models)
+```
+</CodeGroup>
+
+<Tip>
+You can also browse models visually in the [Eden AI model catalog](https://app.edenai.run/models) and filter by capability, including web search.
+</Tip>
+
+<Warning>
+**OpenAI models:** on `/v3/chat/completions`, web search only runs on the dedicated search variants (e.g. `openai/gpt-4o-search-preview`, `openai/gpt-5-search-api`). Other OpenAI models either reject `web_search_options` with a `400` error or accept the request without performing any search. To use web search with regular OpenAI models, call them through the [Responses API](/v3/llms/responses) instead.
+</Warning>
 
 ## Parameters
 
@@ -124,7 +147,7 @@
 }
 
 payload = {
-    "model": "google/gemini-2.5-flash",
+    "model": "google/gemini-flash-latest",
     "messages": [
         {
             "role": "system",
@@ -152,7 +175,7 @@
 
 - **Current events** — news, stock prices, weather, sports scores
 - **Recent releases** — software versions, product launches, research papers
 - **Factual lookups** — statistics, regulations, schedules that change over time
 - **Verification** — checking claims against live sources
 
 <Tip>