Démarrage rapide

Intégrez CoreCtic AI en moins de 3 minutes. Aucune modification de votre logique applicative — un seul changement d'URL suffit.

Compatibilité totale OpenAI

CoreCtic AI implémente la spec OpenAI v1 à 100 %. Tout code qui fonctionne avec le SDK OpenAI official fonctionne avec CoreCtic AI sans aucune autre modification.

Installation en 3 étapes

Créez votre compte & récupérez votre clé API

Rendez-vous sur corecticai.com/auth et créez votre compte. Une clé API est générée automatiquement — elle est toujours préfixée pl_.

Vous la trouverez dans Dashboard → Paramètres → Clés API. Copiez-la et stockez-la dans une variable d'environnement.

bash

# Ajoutez dans votre .env ou .env.local
CORECTIC_API_KEY="pl_xxxxxxxxxxxxxxxxxxxx"

Remplacez l'URL de base

Un seul paramètre change. Votre api_key devient votre clé CoreCtic (pl_...) et votre base_url pointe vers notre proxy :

Python (avant / après)

# Avant — appel direct OpenAI
from openai import OpenAI
client = OpenAI(api_key="sk-proj-...")

# Après — via CoreCtic AI
from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["CORECTIC_API_KEY"],   # pl_...
    base_url="https://api.corecticai.com/v1",
)

Node.js (avant / après)

// Avant
import OpenAI from 'openai';
const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });

// Après
import OpenAI from 'openai';
const client = new OpenAI({
  apiKey: process.env.CORECTIC_API_KEY,   // pl_...
  baseURL: 'https://api.corecticai.com/v1',
});

Envoyez votre première requête

Tout votre code existant fonctionne tel quel. La requête est proxifiée, loguée et optimisée par le cache sémantique :

Python

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Explique le cache sémantique en 2 phrases."}]
)
print(response.choices[0].message.content)

# Le header X-Cache dans la réponse indique :
#   HIT  → répondu depuis le cache (0 token facturé)
#   MISS → appel API effectué (tokens comptabilisés)

Vérifier l'intégration

Après votre première requête, ouvrez le Dashboard. Vous devriez voir :

La requête apparaître dans Logs de requêtes avec modèle, tokens et coût
Le taux de cache passer à HIT dès la deuxième requête similaire
Les métriques de latence P50/P95 mises à jour en temps réel

Troubleshooting courant

Erreur	Cause	Solution
401 Unauthorized	Clé API invalide ou manquante	Vérifiez que la clé commence par pl_ et est correctement passée dans api_key
403 Forbidden	Plan insuffisant pour ce provider	Vérifiez les restrictions de votre plan dans Dashboard → Plans
422 Unprocessable	Modèle non reconnu	Vérifiez l'orthographe exacte du modèle (voir section Providers)
429 Too Many Requests	Rate limit atteint	Plan Standard : 60 req/min. Pro : 300 req/min. Premium : illimité
502 Bad Gateway	Le provider IA est en erreur	Réessayez ou changez de modèle. CoreCtic AI log toutes les erreurs upstream.

Étapes suivantes

Intégration API

Streaming, variables d'env, headers personnalisés

Cache sémantique

Comprendre et monitorer le cache

Providers

Tous les modèles supportés

Analytics

Métriques, coûts et export PDF