Documentation API

🔑 Authentification

Toutes les requêtes exigent une clé API dans l'en-tête Authorization: Bearer sk-dsp-.... Générez votre clé dans votre espace après avoir acheté un pack de crédits.

Authorization: Bearer sk-dsp-votre_cle

La clé complète n'est affichée qu'une seule fois à sa création. Elle est stockée uniquement sous forme hachée (jamais en clair). Conservez-la en lieu sûr.

📋 Lister les modèles TESTÉ

GET https://despresaistudio.com/v1/models

Réponse (format OpenAI) :

{
  "object": "list",
  "data": [
    {"id": "auto", "object": "model"},
    {"id": "gpt-oss:120b", "object": "model"},
    {"id": "qwen3:8b", "object": "model"}
  ]
}

auto choisit automatiquement le modèle rapide (questions simples) ou puissant (questions complexes).

💬 Générer une réponse TESTÉ

POST https://despresaistudio.com/v1/chat/completions
Content-Type: application/json
Authorization: Bearer sk-dsp-votre_cle

{
  "model": "auto",
  "messages": [{"role": "user", "content": "Bonjour"}]
}

Réponse (format OpenAI) :

{
  "id": "chatcmpl-dsp-...",
  "object": "chat.completion",
  "created": 1788187826,
  "model": "qwen3:8b",
  "choices": [{
    "index": 0,
    "message": {"role": "assistant", "content": "Bonjour !"},
    "finish_reason": "stop"
  }],
  "usage": {"credits_charged": 1}
}

⚠️ Fonctionnalités NON implémentées (honnêteté)

L'API est compatible avec le format OpenAI pour les modèles de liste et les complétions non-streamées. Elle n'est pas un remplacement complet d'OpenAI.

💳 Facturation (règle actuelle)

1 appel = 1 crédit, débité après une réponse réussie. Si votre solde est à zéro : erreur 402, aucun débit. Cette règle simple est un tarif de lancement — une tarification par tokens réels suivra.

🛡️ Sécurité & protections (toutes testées)

• ✅ Clés stockées hachées, jamais en clair
• ✅ Clé affichée une seule fois à la création
• ✅ Aucune clé complète dans les logs ni les audits
• ✅ Limite de débit par clé (120 appels / 15 min)
• ✅ Plafond budgétaire mensuel par clé (optionnel)
• ✅ Révocation immédiate d'une clé
• ✅ Isolation stricte : chaque développeur ne voit que ses propres clés et ses propres crédits
• ✅ Idempotence : envoyez l'en-tête Idempotency-Key pour éviter un double débit en cas de nouvelle tentative réseau

🧪 Exemple Python (SDK OpenAI officiel)

from openai import OpenAI

client = OpenAI(
    base_url="https://despresaistudio.com/v1",
    api_key="sk-dsp-votre_cle",
)

resp = client.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "Bonjour"}],
)
print(resp.choices[0].message.content)