Serveur IA

C'est quoi ce serveur ?

Ce serveur est une passerelle vers le modèle Qwen 3.8 27B, mis à disposition par la plateforme IA de l'Université de Reims Champagne-Ardenne (romeogate).

Il parle le même « langage » que l'API d'OpenAI (route /v1/chat/completions) : la plupart des bibliothèques et exemples écrits pour ChatGPT fonctionnent en changeant simplement l'adresse et la clef.

C'est un modèle qui « réfléchit » avant de répondre : il est plus pertinent sur les problèmes complexes, mais cette réflexion consomme aussi des tokens de votre quota.

Comment l'utiliser

1. Envoyez vos requêtes à l'adresse http://localhost:3000/v1/chat/completions en POST.
2. Ajoutez votre clef dans l'en-tête HTTP Authorization: Bearer VOTRE_CLEF (format standard OpenAI) ou, au choix, dans l'en-tête x-api-key.
3. Le champ model est facultatif : par défaut, Qwen 3.8 27B est utilisé.

curl http://localhost:3000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer VOTRE_CLEF" \
  -d '{
    "messages": [{"role": "user", "content": "Explique-moi ce qu'\''est une API REST"}]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:3000/v1",
    api_key="VOTRE_CLEF",
)

reponse = client.chat.completions.create(
    model="ilaas/qwen-3.8-27b",
    messages=[{"role": "user", "content": "Donne-moi 3 idées de projet web"}],
)
print(reponse.choices[0].message.content)

// ==========================================================================
// ⚠️  À UTILISER UNIQUEMENT EN NODE.JS (côté serveur), JAMAIS DANS UNE PAGE WEB !
//
//     Votre clef d'API doit rester SECRÈTE : dans une page web, elle serait
//     visible par tous les visiteurs (code source, outils de développement…)
//     et n'importe qui pourrait l'utiliser à votre place.
//
//     Bonne pratique : stockez-la dans une variable d'environnement
//     (fichier .env, jamais publié sur GitHub) et lisez-la avec process.env.
// ==========================================================================

const reponse = await fetch("http://localhost:3000/v1/chat/completions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer VOTRE_CLEF",
  },
  body: JSON.stringify({
    messages: [{ role: "user", content: "Corrige ce code : console.log('bonjour'" }],
  }),
});

const data = await reponse.json();
console.log(data.choices[0].message.content);

<?php
// La clef reste côté serveur : elle n'est jamais envoyée au navigateur du visiteur.
$clef = "VOTRE_CLEF"; // idéalement : getenv("CLEF_API_IA")

$ch = curl_init("http://localhost:3000/v1/chat/completions");
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        "Content-Type: application/json",
        "Authorization: Bearer $clef",
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        "messages" => [
            ["role" => "user", "content" => "Écris une fonction PHP qui vérifie un email"],
        ],
    ]),
]);

$reponse = curl_exec($ch);
if ($reponse === false) {
    die("Erreur réseau : " . curl_error($ch));
}

$data = json_decode($reponse, true);
if (isset($data["error"])) {
    die("Erreur : " . $data["error"]);
}
echo $data["choices"][0]["message"]["content"];

Bon à savoir

• Outils compatibles OpenAI (VS Code, Continue, Cursor…) : choisissez un fournisseur « OpenAI compatible » ou « custom endpoint », avec l'adresse http://localhost:3000/v1, votre clef, et le modèle ilaas/qwen-3.8-27b.
• Streaming : ajoutez "stream": true pour recevoir la réponse au fur et à mesure.
• Images : le modèle sait lire des images, envoyées au format image_url d'OpenAI.
• Gardez votre clef pour vous : ne la publiez pas sur GitHub ni dans du code côté navigateur mis en ligne. Toute utilisation est décomptée de votre quota.

Limites de tokens

Un token est un morceau de mot (environ ¾ de mot en français). Chaque requête consomme les tokens de votre question et ceux de la réponse.

• Chaque clef dispose d'un quota hebdomadaire (200 000 tokens par défaut, de quoi tenir de nombreux échanges).
• Le compteur est remis à zéro chaque vendredi à 20h.
• Dans une conversation, tout l'historique est renvoyé à chaque message : plus elle est longue, plus chaque message coûte cher. Repartez d'une nouvelle conversation quand vous changez de sujet.
• Les agents de code (dans VS Code par exemple) envoient beaucoup de contexte à chaque requête et consomment vite le quota.
• Quand le quota est épuisé, le serveur répond avec une erreur 403 jusqu'à la prochaine remise à zéro.

Vérifier mon quota

Votre clef sert uniquement à interroger le serveur, elle n'est enregistrée nulle part.

En ligne de commande : curl -H "Authorization: Bearer VOTRE_CLEF" http://localhost:3000/quota