4-4 AI en 5 minutes : se connecter à une API IA unifiée

Tutoriel · 2026-11-20 · 8 min de lecture

Ce tutoriel vous guide de zéro jusqu’à la connexion complète à 4-4 AI : obtenir la clé → configurer la Base URL → faire tourner la première sortie en streaming. Tout se fait via l’interface compatible OpenAI — tout code, framework ou outil existant prenant en charge une Base URL personnalisée (SDK openai, LangChain, Cursor, etc.) ne demande aucune modification de la logique du code, seulement de la configuration.

Préparation

  1. Rendez-vous sur www.4-4.vip, créez un compte et connectez-vous à la console ;
  2. Rechargez votre compte dans la console ou échangez un code de carte ;
  3. Sur la page « Tokens », créez une nouvelle clé API (format sk-...) et conservez-la précieusement — elle n’est affichée intégralement qu’une seule fois, à la création.
Conseil de sécurité : une clé API vaut le crédit du compte. Ne la commitez pas dans un dépôt Git ni dans du code front-end. Privilégiez les variables d’environnement.

Concept clé : Base URL et clé

4-4 AI propose un protocole d’interface entièrement compatible OpenAI. Il suffit de retenir deux configurations :

ÉlémentValeur
Base URLhttps://www.4-4.vip/v1
API KeyLa clé sk-... créée sur la page Tokens de la console
Paramètre modelIndiquez le nom du modèle selon vos besoins, par ex. deepseek-chat, glm-4, etc. (la liste des modèles de la console fait foi)

Changer de modèle = ne modifier que le paramètre model ; changer de fournisseur = ne modifier que la Base URL. C’est là toute la valeur d’une passerelle unifiée : découpler le code métier du fournisseur de modèles.

Méthode 1 : cURL (le plus rapide pour vérifier la connectivité)

curl https://www.4-4.vip/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $44AI_API_KEY" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "user", "content": "Introduce yourself in one sentence"}
    ]
  }'

Si le JSON renvoyé contient choices[0].message.content, toute la chaîne fonctionne.

Méthode 2 : Python (SDK officiel openai)

pip install openai
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["44AI_API_KEY"],          # your 4-4 AI key
    base_url="https://www.4-4.vip/v1"            # key: point to the 4-4 AI gateway
)

# regular call
resp = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Write a quicksort in Python"}]
)
print(resp.choices[0].message.content)

# streaming output
stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Tell me a nerdy joke"}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta
    if delta and delta.content:
        print(delta.content, end="", flush=True)

Méthode 3 : Node.js

npm install openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.N44_API_KEY,
  baseURL: "https://www.4-4.vip/v1",
});

const completion = await client.chat.completions.create({
  model: "deepseek-chat",
  messages: [{ role: "user", content: "Write a debounce function in TypeScript" }],
});
console.log(completion.choices[0].message.content);

Connecter les frameworks et outils principaux

Questions fréquentes (FAQ)

Erreur 401 Invalid API Key ?

Vérifiez dans l’ordre : ① des espaces ou des sauts de ligne ont-ils été copiés avec la clé ; ② la clé est-elle désactivée/supprimée dans la liste des tokens de la console ; ③ le crédit du compte est-il épuisé ; ④ l’en-tête Authorization est-il au format Bearer sk-... (attention à l’espace après Bearer).

Erreur 429, trop de requêtes ?

La passerelle applique une limite de débit par token. Réduisez le parallélisme, allongez les back-offs de nouvelle tentative (back-off exponentiel + jitter recommandés) ou augmentez la limite de débit du token dans la console.

La sortie en streaming se coupe en cours de route ?

Pour les longues réponses, activez plutôt la relance sur dépassement de délai du SDK ; si vous passez par un proxy d’entreprise, vérifiez qu’il ne met pas en tampon le flux SSE (text/event-stream).

Quels modèles sont pris en charge ?

La liste en temps réel de la page « Modèles » de la console fait foi. 4-4 AI agrège GLM, DeepSeek, Qwen et autres modèles phares — une seule clé, une seule interface, et vous changez de modèle.

Articles liés

one-api / new-api auto-hébergé vs passerelle IA gérée : coûts, opérations et sécurité Un cadre de décision honnête pour les équipes qui hésitent entre « construire ou acheter » : coûts d’exploitat Connecter Cursor / Claude Code / Cherry Studio à une passerelle IA personnalisée Configuration de Base URL personnalisée pour les principaux outils de code et de chat IA, avec mémo de dépanna
Prêt à vous connecter ?

Une clé pour GLM, DeepSeek, Qwen et autres modèles phares — facturation unifiée et suivi visuel de l’utilisation.

Voir les modèles et tarifs Essayer gratuitement