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

# Obtenir la liste des modèles

> Afin de connaître les modèles auxquels vous pouvez avoir accès via Paradigm, un endpoint dédié est disponible pour obtenir la liste des modèles disponibles.

Cet endpoint vous permet de récupérer tous les modèles IA disponibles pour votre clé API. Utilisez-le pour découvrir quels modèles vous pouvez utiliser pour les complétions de chat, les embeddings, et autres opérations IA.

<Note>
  **Visibilité des modèles**

  Veuillez noter que les modèles listés sont les modèles accessibles pour votre clé API.
  Si votre clé API n'a pas reçu l'accès à un modèle, vous ne trouverez pas ce modèle dans la réponse provenant de l'endpoint API.

  Si vous ne trouvez pas un modèle spécifique dans la réponse, depuis l'interface d'administration veuillez vérifier que :

  * Le modèle existe dans Paradigm
  * Votre clé API a accès à ce modèle
</Note>

## Prérequis

* Une **clé API Paradigm** : si vous n'en avez pas, rendez-vous sur votre profil Paradigm (`/settings/api-key` dans votre instance) et générez une nouvelle clé API.

## Méthodes d'utilisation

Il existe plusieurs façons d'appeler l'endpoint :

1. Avec le **package python `requests`**
2. Via une **requête curl** : pour des tests rapides ou une première utilisation

## Package python `requests`

Vous pouvez envoyer directement une requête à l'endpoint API via le package `requests`.

```python theme={null}
import requests
import os

# Récupérer la clé API et l'URL de base depuis l'environnement
api_key = os.getenv("PARADIGM_API_KEY")
base_url = os.getenv("PARADIGM_BASE_URL", "https://paradigm.lighton.ai/api/v2")

response = requests.request(
    method="GET",
    url=f"{base_url}/models",
    headers={
        'accept': "application/json",
        'Authorization': f"Bearer {api_key}"
    }
)

print(response.json())
```

Vous obtiendriez alors une réponse JSON sous forme de dictionnaire :

```json theme={null}
{
    "object": "list",
    "data": [
        {
            "object": "model",
            "name": "Alfred 4",
            "model_type": "Large Language Model",
            "deployment_type": "SageMaker",
            "enabled": true,
            "technical_name": "alfred-4"
        }
    ]
}
```

## Requête cURL

Si vous préférez envoyer une requête à Paradigm avec une simple commande cURL, voici un exemple :

```shell theme={null}
curl --request GET \
  --url $PARADIGM_BASE_URL/models \
  --header 'Authorization: Bearer $PARADIGM_API_KEY'
```