diff --git a/v3/data-governance/eu-endpoint.mdx b/v3/data-governance/eu-endpoint.mdx index db73ed1..27b43d6 100644 --- a/v3/data-governance/eu-endpoint.mdx +++ b/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 + } } ``` diff --git a/v3/llms/listing-models.mdx b/v3/llms/listing-models.mdx index e8807c2..b8c08ae 100644 --- a/v3/llms/listing-models.mdx +++ b/v3/llms/listing-models.mdx @@ -1,23 +1,23 @@ --- 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"; -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 @@ -25,30 +25,26 @@ Use the `/v3/models` endpoint to retrieve all LLM models available through Eden GET /v3/models ``` +The endpoint is public: no API key is required. + ## Example ```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 @@ data.forEach(model => console.log(model.id)); ## 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 @@ Each model `id` is used directly as the `model` parameter in your requests. ## 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 @@ The `capabilities` object describes what each model supports: | 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". You can also browse all features and providers visually in the [Eden AI model catalog](https://app.edenai.run/models). diff --git a/v3/llms/web-search.mdx b/v3/llms/web-search.mdx index d9f1f2f..8cdbfe9 100644 --- a/v3/llms/web-search.mdx +++ b/v3/llms/web-search.mdx @@ -14,7 +14,7 @@ import { TechArticleSchema } from "/snippets/TechArticleSchema.mdx"; 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. @@ -40,7 +40,7 @@ headers = { } 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?"} ], @@ -62,7 +62,7 @@ const headers = { }; 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 @@ curl -X POST https://api.edenai.run/v3/chat/completions \ -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 @@ curl -X POST https://api.edenai.run/v3/chat/completions \ ## 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`: + + +```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) +``` + + + +You can also browse models visually in the [Eden AI model catalog](https://app.edenai.run/models) and filter by capability, including web search. + + + +**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. + ## Parameters @@ -124,7 +147,7 @@ headers = { } payload = { - "model": "google/gemini-2.5-flash", + "model": "google/gemini-flash-latest", "messages": [ { "role": "system",