# Démarrage rapide

## 1. Obtenir une clé API

1. Connectez-vous à ce portail développeur.
2. Ouvrez **Tarifs**, souscrivez au plan **Paiement à l’usage**, puis finalisez le paiement.
3. Copiez la clé API de votre abonnement.

## 2. Lister les modèles

```bash
curl --request GET \
  --url https://ai.qlub.social/v1/models \
  --header "Authorization: Bearer $QLUB_AI_API_KEY"
```

## 3. Appeler le chat

Choisissez un identifiant réel du catalogue (ex. `gpt-oss-120b`).

```bash
curl --request POST \
  --url https://ai.qlub.social/v1/chat/completions \
  --header "Authorization: Bearer $QLUB_AI_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "gpt-oss-120b",
    "messages": [
      {
        "role": "user",
        "content": "Explique la souveraineté numérique en une phrase."
      }
    ]
  }'
```

## 4. Vérifier l’usage

Les réponses JSON non streamées incluent `usage.prompt_tokens` et `usage.completion_tokens`, utilisés pour la facturation (voir [Tarifs](/pricing)).

## URL de base

| Environnement | URL de base |
|---------------|-------------|
| Production | `https://ai.qlub.social` |
| Déploiement actuel | `https://qlub-ia-main-b7126ca.zuplo.app` |

Chemins : `GET /v1/models` · `POST /v1/chat/completions`