Skip to content
Last updated

๐Ÿ”จ 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.
GEThttps://api.freddy.aitronos.com/v1/models

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.

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

Response

{
  "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
}