Configuration d'Instance

Configurez vos applications pour qu’elles fonctionnent avec l’instance gérée par LightOn (offre SaaS) ou les instances que vous gérez vous-même (offres air-gapped et souveraines).

Paradigm peut être déployé dans différentes configurations pour répondre aux besoins de votre organisation. Comprendre comment configurer vos applications pour différents types d’instances est crucial pour une intégration API appropriée.

​

Types d’Instances

​

Instance gérée par LightOn

• URL : https://paradigm.lighton.ai
• Gestion : Entièrement gérée par LightOn
• Adaptée pour : Organisations confortables avec les solutions SaaS

​

Instance gérée par le client

• URL : Domaine personnalisé fourni par votre organisation
• Gestion : Gérée par votre équipe IT ou le support LightOn
• Adaptée pour : Organisations nécessitant un déploiement sur site ou des exigences de conformité spécifiques

​

Bonnes Pratiques de Configuration

​

Variables d’Environnement

Utilisez toujours des variables d’environnement pour rendre votre code flexible entre différentes instances :

import os

# Recommandé : Utilisez des variables d'environnement pour la configuration
PARADIGM_API_KEY = os.getenv("PARADIGM_API_KEY")
PARADIGM_BASE_URL = os.getenv("PARADIGM_BASE_URL", "https://paradigm.lighton.ai/api/v2")

​

Exemples de Configuration

​

Pour l’Instance gérée par LightOn

# Fichier .env ou variables d'environnement
export PARADIGM_API_KEY="your_api_key_here"
export PARADIGM_BASE_URL="https://paradigm.lighton.ai/api/v2"

​

Pour l’Instance gérée par le client

# Fichier .env ou variables d'environnement
export PARADIGM_API_KEY="your_api_key_here"
export PARADIGM_BASE_URL="https://your-company-paradigm.example.com/api/v2"

​

Implémentation Code

import requests
import os

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

# Valider la configuration
if not api_key:
    raise ValueError("La variable d'environnement PARADIGM_API_KEY est requise")

if not base_url:
    raise ValueError("La variable d'environnement PARADIGM_BASE_URL est requise")

​

Déterminer Votre Type d’Instance

​

Vérifier avec Votre Administrateur

Contactez votre administrateur Paradigm ou équipe IT pour confirmer :

• Quel type d’instance votre organisation utilise
• La bonne URL de base pour les appels API
• Toute exigence réseau spécifique (proxies, VPN, etc.)

​

Validation de Configuration

Vous pouvez tester votre configuration en appelant l’endpoint des modèles :

try:
    response = requests.get(
		url=f"{base_url}/models",
		headers={"Authorization": f"Bearer {api_key}"}
	)
    data = response.json()
    print("✅ Configuration réussie !")
    print(f"Connecté à : {base_url}")
    print(f"Modèles disponibles : {len(data['data'])}")
except Exception as e:
    print("❌ Configuration échouée :")
    print(f"Erreur : {e}")
    print("Veuillez vérifier votre PARADIGM_BASE_URL et PARADIGM_API_KEY")

​

Considérations de Sécurité

​

Instances Privées

• Assurez-vous que votre réseau permet l’accès à votre instance privée
• Configurez les paramètres proxy nécessaires (voir configuration proxy)
• Vérifiez que les certificats SSL/TLS sont correctement configurés

​

Gestion des Clés API

• Ne jamais hardcoder les clés API dans votre code source
• Utilisez une gestion sécurisée des variables d’environnement
• Faites rotation des clés API régulièrement selon la politique de sécurité de votre organisation
• Stockez les clés API dans des systèmes de gestion d’identifiants sécurisés

​

Dépannage

​

Problèmes Courants

Problème	Cause	Solution
Timeout de connexion	Mauvaise URL de base ou problèmes réseau	Vérifier l’URL et la connectivité réseau
Échec d’authentification	Clé API invalide ou identifiants expirés	Vérifier la clé API et la régénérer si nécessaire
Erreurs de certificat SSL	Certificats auto-signés sur instances privées	Configurer la vérification SSL appropriée
Erreurs de proxy	Pare-feu d’entreprise bloquant les requêtes	Configurer les paramètres proxy

​

Obtenir de l’Aide

• Instance Publique : Contactez le Support LightOn
• Instance Privée : Contactez votre équipe IT interne ou votre contact support LightOn désigné