# List models

div
strong
🔨 In Development
 — This section is still being developed and may change.


Retrieve a list of available AI models with their capabilities, pricing, and configuration details.

#### Query Parameters

**`ui_models_only`** boolean optional · Defaults to `false`

Filter to show only UI-visible models. When `true`, returns only models that should be displayed in user interfaces.

**`include_pricing`** boolean optional · Defaults to `false`

Include pricing information (`input_synapses_cost`, `output_synapses_cost`) in the response.

**`include_details`** boolean optional · Defaults to `false`

Include detailed model information (`provider`, `context_window`, `release_date`, `training_data_cutoff`, `added_to_aitronos_date`, `description`, `recommended_for`).

**`include_capabilities`** boolean optional · Defaults to `true`

Include model capabilities array (text_generation, vision, tool_calling, etc.).

**`include_deprecated`** boolean optional · Defaults to `false`

Include deprecated models in the response.

**`include_legacy`** boolean optional · Defaults to `false`

Include legacy models that may be phased out.

## Returns

A list of [Model objects](/docs/api-reference/objects/model-object).

All Models

```bash
curl "https://api.freddy.aitronos.com/v1/models" \
  -H "Authorization: Bearer $FREDDY_API_KEY"
```


```python
import requests

response = requests.get(
    "https://api.freddy.aitronos.com/v1/models",
    headers={"Authorization": f"Bearer {api_key}"}
)

models = response.json()
print(f"Found {models['totalCount']} models")
for model in models['models']:
    print(f"- {model['name']} ({model['id']})")
```


```javascript
const response = await fetch('https://api.freddy.aitronos.com/v1/models', {
  headers: {
    'Authorization': `Bearer ${apiKey}`
  }
});

const models = await response.json();
console.log(`Found ${models.totalCount} models`);
models.models.forEach(model => {
  console.log(`- ${model.name} (${model.id})`);
});
```

With Pricing & Details

```bash
curl "https://api.freddy.aitronos.com/v1/models?include_pricing=true&include_details=true" \
  -H "Authorization: Bearer $FREDDY_API_KEY"
```


```python
import requests

response = requests.get(
    "https://api.freddy.aitronos.com/v1/models",
    headers={"Authorization": f"Bearer {api_key}"},
    params={
        "include_pricing": True,
        "include_details": True
    }
)

models = response.json()
for model in models['models']:
    print(f"{model['name']}: ${model['pricing']['input_synapses_cost']}/1M input")
```


```javascript
const response = await fetch('https://api.freddy.aitronos.com/v1/models?include_pricing=true&include_details=true', {
  headers: {
    'Authorization': `Bearer ${apiKey}`
  }
});

const models = await response.json();
models.models.forEach(model => {
  console.log(`${model.name}: $${model.pricing.input_synapses_cost}/1M input`);
});
```

Minimal Response

```bash
curl "https://api.freddy.aitronos.com/v1/models?include_capabilities=false" \
  -H "Authorization: Bearer $FREDDY_API_KEY"
```


```python
import requests

response = requests.get(
    "https://api.freddy.aitronos.com/v1/models",
    headers={"Authorization": f"Bearer {api_key}"},
    params={"include_capabilities": False}
)

models = response.json()
# Returns only: id, key, name, is_visible_in_ui, is_deprecated
```


```javascript
const response = await fetch('https://api.freddy.aitronos.com/v1/models?include_capabilities=false', {
  headers: {
    'Authorization': `Bearer ${apiKey}`
  }
});

const models = await response.json();
// Returns only: id, key, name, is_visible_in_ui, is_deprecated
```

## Response


```json
{
  "models": [
    {
      "id": "mdl_09adacc3e5d3",
      "key": "gpt-4o",
      "name": "GPT-4o",
      "description": "Most advanced multimodal model with vision, audio, and tool calling capabilities",
      "provider": "openai",
      "is_visible_in_ui": true,
      "is_deprecated": false,
      "availability_status": "general_availability",
      "capabilities": [
        "text_generation",
        "conversation",
        "streaming",
        "tool_calling",
        "vision",
        "audio",
        "code_interpreter",
        "web_search",
        "file_search",
        "structured_output"
      ],
      "context_window": 128000,
      "pricing": {
        "input_synapses_cost": 2.50,
        "output_synapses_cost": 10.00
      },
      "release_date": "2024-05-13T00:00:00Z",
      "model_version": "2024-05-13",
      "training_data_cutoff": "2023-10-01T00:00:00Z",
      "added_to_aitronos_date": "2024-05-13T00:00:00Z",
      "recommended_for": [
        "general_purpose",
        "multimodal",
        "tool_calling",
        "vision",
        "audio"
      ],
      "use_cases": "Ideal for applications requiring multimodal understanding, complex reasoning, and tool integration. Excels at code generation, data analysis, image understanding, and audio processing.",
      "strengths": "Superior multimodal capabilities, advanced reasoning, excellent code generation, strong tool calling support, and high-quality vision understanding.",
      "limitations": "Higher cost compared to smaller models, may be overkill for simple text-only tasks.",
      "performance_ratings": {
        "reasoning": 4,
        "speed": 3,
        "price_to_performance": 3,
        "input_capabilities": 4,
        "output_capabilities": 4
      },
      "benchmark_scores": {
        "mmlu": 88.7,
        "humaneval": 92.0,
        "gsm8k": 94.8,
        "hellaswag": 95.3
      },
      "documentation_url": "https://docs.freddy.aitronos.com/models/gpt-4o",
      "provider_docs_url": "https://platform.openai.com/docs/models/gpt-4o",
      "badge": "recommended"
    }
  ],
  "totalCount": 1
}
```