> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Modelos de IA

> Descubre y valida los modelos de IA disponibles para los nodos AI Agent y AI_TASK: filtros por proveedor y capacidad, validación y caché del catálogo.

`jelou models` consulta el catálogo de modelos de IA disponibles para tu
organización — los que puedes usar en los nodos **AI Agent** y **AI\_TASK**.
Sirve para dos cosas: descubrir qué modelos tienes y validar que el nombre que
vas a escribir en un workflow existe.

<Tip>
  Si tu agente ya necesita otro contexto del workspace (identidad, drift del
  proyecto, secretos, bases de datos), `jelou context --agent` trae todo eso en
  una sola llamada, incluyendo el mismo listado de modelos permitidos en
  `data.models` (con `source`, `fetchedAt`, `count`, `allowed[]`, `deprecated[]`
  y `byProvider{}`). Es un atajo útil cuando de todas formas vas a pedir ese
  contexto más amplio.
</Tip>

## Listar

```bash theme={null}
jelou models list                                  # todos
jelou models list --provider anthropic             # de un proveedor
jelou models list --capability vision --json       # que soporten imágenes
```

| Flag                                              | Descripción                                                                                 |
| ------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| `--provider <nombre>`                             | Filtra por proveedor                                                                        |
| `--capability <cap>`                              | `vision`, `json`, `pdf`, `reasoning`, `streaming`, `audio`, `system`, `tools`, `structured` |
| `--type <tipo>`                                   | `platform` (de la plataforma) o `custom` (tuyos)                                            |
| `--include-deprecated`                            | Incluye modelos con fecha de fin de vida                                                    |
| `--no-cache`                                      | Consulta fresca, ignora la caché local                                                      |
| `--sort <catalog\|name\|input-cost\|output-cost>` | Orden de los resultados (por defecto `catalog`)                                             |
| `--max-input-cost <número>`                       | Solo modelos con costo de entrada por 1M tokens igual o menor al indicado                   |
| `--max-output-cost <número>`                      | Solo modelos con costo de salida por 1M tokens igual o menor al indicado                    |

Los modelos deprecados **no aparecen** salvo que pases `--include-deprecated`.

## Ver detalle

Acepta el nombre corto, el id calificado o el id numérico:

```bash theme={null}
jelou models show gpt-4.1
jelou models show openai/gpt-4.1
```

## Validar

Confirma que un modelo existe antes de escribirlo en un workflow. Es el comando
pensado para CI y para agentes:

```bash theme={null}
jelou models validate openai/gpt-4.1        # forma canónica
jelou models validate gpt-4.1               # forma corta, se expande sola
jelou models validate gpt-4o --provider openai
```

| Código de salida | Significado                                               |
| ---------------- | --------------------------------------------------------- |
| `0`              | Válido y no deprecado                                     |
| `2`              | Deprecado, o el nombre corto es ambiguo entre proveedores |
| `3`              | No existe en el catálogo                                  |

| Flag                  | Descripción                                                    |
| --------------------- | -------------------------------------------------------------- |
| `--provider <nombre>` | Exige que el modelo pertenezca a ese proveedor                 |
| `--allow-deprecated`  | Trata los deprecados como válidos (salida `0` con advertencia) |

<Tip>
  `--provider` es útil para validar el par modelo+proveedor de un `fallbackModel`
  antes de publicar un workflow.
</Tip>

## Caché del catálogo

El catálogo se guarda en disco para no consultar la API en cada llamada. Si
acabas de habilitar un modelo y no aparece:

```bash theme={null}
jelou models refresh                        # consulta fresca y reescribe la caché
jelou models refresh --clear                # borra la caché del perfil activo
jelou models refresh --clear --all-profiles # borra la de todos los perfiles
```

También puedes pasar `--no-cache` a `list`, `show` y `validate` para una consulta
puntual sin tocar la caché.