---
title: "Listar modelos disponíveis"
method: GET
path: "/api/management/ai/available-models"
tags: ["ai-agents", "available-models"]
---

# Listar modelos disponíveis

`GET /api/management/ai/available-models`

Lista os modelos de IA que podem ser escolhidos como padrão de um agente, reunindo os catálogos de todos os provedores. Os identificadores devolvidos em `id` e `internal_provider` são os valores aceitos em `default_model` e `default_provider` do agente. O catálogo do OpenRouter é consultado ao vivo e acompanha o preço convertido em créditos.

## Query parameters

- `search` string
- `supportedParameters[]` string

## Response `200`

Sucesso

- object — Catálogo de modelos de todos os provedores.
  - `response` boolean — Indicador de sucesso da requisição; sempre verdadeiro nesta resposta.
  - `models` object[] — Modelos disponíveis, agrupados por provedor na ordem openrouter, google, openai e anthropic.
    - `id` string — Identificador do modelo; é o valor aceito em `default_model` do agente.
    - `name` string — Nome do modelo para exibição.
    - `internal_provider` 'openrouter' | 'google' | 'openai' | 'anthropic' — Provedor que oferece o modelo; é o valor aceito em `default_provider` do agente.
    - `context_length` integer, nullable — Tamanho máximo da janela de contexto do modelo, em tokens.
    - `input_modalities` string[] — Tipos de conteúdo que o modelo aceita na entrada, como texto, imagem e arquivo.
    - `output_modalities` string[] — Tipos de conteúdo que o modelo produz na saída.
    - `supported_parameters` string[] — Recursos suportados pelo modelo, como uso de ferramentas, saída estruturada, busca na internet e raciocínio.
    - `pricing_in_credits` object — Preço do modelo convertido para a unidade de créditos da carteira, já com a margem aplicada. Presente nos modelos do catálogo do OpenRouter; nulo quando o modelo não tem preço público.
      - `prompt_per_1m` number, nullable — Créditos por 1 milhão de tokens de entrada.
      - `completion_per_1m` number, nullable — Créditos por 1 milhão de tokens de saída.
      - `request` number, nullable — Créditos cobrados por requisição, independentemente dos tokens.
      - `image_per_unit` number, nullable — Créditos por imagem enviada ao modelo.
      - `web_search_per_unit` number, nullable — Créditos por busca na internet feita pelo modelo.
      - `internal_reasoning_per_1m` number, nullable — Créditos por 1 milhão de tokens de raciocínio interno.
      - `input_cache_read_per_1m` number, nullable — Créditos por 1 milhão de tokens de entrada lidos do cache.
      - `input_cache_write_per_1m` number, nullable — Créditos por 1 milhão de tokens de entrada gravados no cache.
    - `pricing` unknown

## Changes

- **2026-09-22** `d71b18b1685d` — 1 breaking, 4 warning, 2 info
  - the response property `models/items/context_length` became nullable for the status `200`
  - added the new `anthropic` enum value to the `models/items/internal_provider` response property for the response status `200`
  - added the new `google` enum value to the `models/items/internal_provider` response property for the response status `200`
  - added the new `openai` enum value to the `models/items/internal_provider` response property for the response status `200`
  - …3 more
- **2026-09-22** `b43a04f35145` — 1 warning
  - removed the optional property `models/items/pricing_in_credits` from the response with the `200` status
- **2026-09-18** `e3c5b00568f3` — 3 info
  - added the new optional `query` request parameter `search`
  - added the new optional `query` request parameter `supportedParameters[]`
  - added the media type `application/json` for the response with the status `200`

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/ai/available-models/get.md)

---

[API](https://skmtc.dev/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.dev/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc.dev/olie-ai/apis/olie-api/revisions/d7bda7d32f67?raw)
