# Qwen

Source: https://docs.aicentos.com/fr/clients/qwen

Language: fr

> Utiliser aicentos dans Qwen Code : configurer un provider compatible OpenAI via settings.json

Qwen Code permet d'enregistrer n'importe quel point d'accès compatible OpenAI via `modelProviders` dans `settings.json`. Pointez `baseUrl` vers aicentos et les modèles intégrés par aicentos deviennent utilisables dans Qwen Code.

## Prérequis

Créez d'abord dans la console, page « Clés API », une clé dédiée pour Qwen Code (nommez-la par exemple `qwen-code`, pour suivre plus facilement sa consommation).

* Console : [https://aicentos.com](https://aicentos.com)
* Créer une clé : [https://aicentos.com/keys](https://aicentos.com/keys)
* Recharger le portefeuille : [https://aicentos.com/wallet](https://aicentos.com/wallet)
* Site de documentation : [https://docs.aicentos.com](https://docs.aicentos.com)

Qwen Code exige Node.js 20 ou supérieur ; installez-le globalement via npm :

```bash
npm install -g @qwen-code/qwen-code
qwen --version
```

## Configuration à renseigner

| Champ        | Valeur                                                               |
| ------------ | -------------------------------------------------------------------- |
| Type d'auth  | `openai` (protocole compatible OpenAI)                               |
| baseUrl      | `https://aicentos.com/v1`                                            |
| envKey       | nom de la variable d'environnement stockant la clé (personnalisable) |
| id du modèle | nom du modèle dans la « place de marché des modèles » de la console  |

## Étapes de configuration

Éditez `~/.qwen/settings.json` :

```json
{
  "env": {
    "AICENTOS_API_KEY": "sk-votre-clé"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "gpt-4o",
        "name": "GPT-4o",
        "baseUrl": "https://aicentos.com/v1",
        "envKey": "AICENTOS_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "gpt-4o"
  }
}
```

* `id` est l'identifiant de modèle réellement envoyé au serveur ; il doit correspondre au nom du modèle dans la console.
* Dans `modelProviders`, n'écrivez pas la clé en clair : `envKey` n'est qu'une référence indiquant « dans quelle variable d'environnement aller chercher la clé ».
* Priorité de la clé : variables d'environnement système > fichier `.env` (`~/.qwen/.env`) > bloc `env` de `settings.json`.
* Si le côté aicentos passe par le protocole Responses, ajoutez `"wireApi": "responses"` sur ce modèle ; sans cela, Chat Completions est utilisé par défaut.

Vous pouvez aussi éviter complètement de modifier le fichier de configuration et passer par des variables d'environnement :

```bash
export OPENAI_BASE_URL="https://aicentos.com/v1"
export OPENAI_API_KEY="sk-votre-clé"
export OPENAI_MODEL="gpt-4o"
```

## Test

Lancez `qwen`, vérifiez avec `/about` que le endpoint et le modèle courant sont corrects, puis envoyez un prompt simple. Si plusieurs entrées de provider sont configurées, vous pouvez basculer avec `/model`.

## Remarques

* La configuration globale se place dans `~/.qwen/settings.json`, la configuration de projet dans `.qwen/settings.json` à la racine du projet, cette dernière étant prioritaire.
* `security.auth.selectedType` doit valoir `openai`, sinon le point d'accès personnalisé n'est pas utilisé.
* Ne commitez pas la clé en clair dans un dépôt ; préférez `~/.qwen/.env` ou les variables d'environnement système.
* `wireApi` n'est qu'une métadonnée de routage locale, elle n'est pas envoyée dans le corps de la requête ; avant de passer à `responses`, vérifiez que le côté aicentos prend en charge `/v1/responses`.
* La Base URL s'arrête à `/v1`, ne la complétez pas en chemin d'interface complet.