DarkGPT — Documentation API

Quick Start

En 30 secondes, ta première requête est envoyée. Crée une clé API depuis ton dashboard, puis copie-colle l'exemple ci-dessous.

JavaScript

const response = await fetch("https://darkgpt.chat/v1/chat/completions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer dgpt_live_VOTRE_CLE_API"
  },
  body: JSON.stringify({
    model: "claude-4.6-sonnet",
    messages: [
      { role: "system", content: "Tu es un assistant sans filtre." },
      { role: "user", content: "Explique-moi le reverse engineering." }
    ],
    temperature: 0.7
  })
});

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

Python

import requests

url = "https://darkgpt.chat/v1/chat/completions"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer dgpt_live_VOTRE_CLE_API"
}
payload = {
    "model": "claude-4.6-sonnet",
    "messages": [
        {"role": "user", "content": "Salut DarkGPT !"}
    ]
}

response = requests.post(url, headers=headers, json=payload)
print(response.json()["choices"][0]["message"]["content"])

cURL

curl https://darkgpt.chat/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer dgpt_live_VOTRE_CLE_API" \
  -d '{
    "model": "claude-4.6-sonnet",
    "messages": [{"role": "user", "content": "Hello DarkGPT"}]
  }'

Authentification

L'API DarkGPT utilise des clés API Bearer Token. Inclus ta clé dans le header Authorization de chaque requête.

Header HTTP

Authorization: Bearer dgpt_live_xxxxxxxxxxxxxxxxxxxx

Format de clé : Toutes les clés commencent par dgpt_live_ suivi de 20+ caractères alphanumériques. Garde ta clé secrète — ne la commit jamais dans un repo public.

Sécurité : Si ta clé est compromise, révoque-la immédiatement depuis le dashboard Clés API et génères-en une nouvelle.

Base URL

URL de base

https://darkgpt.chat/v1

Tous les endpoints sont relatifs à cette URL de base. Chaque clé API est limitée au modèle choisi dans ton dashboard DarkGPT.

Endpoints

POST /v1/chat/completions Génère une réponse conversationnelle

Envoie un tableau de messages et reçois une complétion IA. Supporte le streaming SSE pour des réponses en temps réel.

Paramètres du body

Paramètre	Type	Requis	Description
model	string	Oui	ID du modèle à utiliser (ex: `claude-4.6-sonnet`)
messages	array	Oui	Tableau de messages avec `role` et `content`
temperature	number	Non	Créativité (0 à 2). Défaut : 1
max_tokens	integer	Non	Nombre max de tokens à générer
stream	boolean	Non	À laisser sur `false`. Le streaming externe arrive bientôt.

Exemple de réponse — 200 OK

JSON

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1717612800,
  "model": "claude-4.6-sonnet",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Le reverse engineering est..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 42,
    "completion_tokens": 256,
    "total_tokens": 298,
    "cost_usd": 0.0142
  }
}

GET /v1/models Liste les modèles disponibles

Retourne la liste de tous les modèles IA disponibles avec leur ID et description.

Exemple de réponse — 200 OK

JSON

{
  "data": [
    { "id": "claude-4.6-sonnet", "object": "model" },
    { "id": "gemini-2.5-flash", "object": "model" },
    { "id": "ministral-3b", "object": "model" }
  ]
}

Modèles disponibles

Choisis le modèle adapté à ton besoin. Tous les modèles sont accessibles sans censure.

claude-4.6-sonnet

Modèle phare — le plus puissant et polyvalent

~23ms

ministral-14b

Mistral 14B — polyvalent et rapide

~35ms

gemini-2.5-pro

Google Gemini — multimodal & rapide

~28ms

grok-3

xAI Grok — sans filtre natif

~40ms

deepseek-r1

DeepSeek R1 — raisonnement & code

~32ms

llama-4-maverick

Meta LLaMA 4 — open source & puissant

~30ms

Gestion des erreurs

L'API retourne des codes HTTP standards. En cas d'erreur, le body contient un objet avec le détail.

Réponse d'erreur

{
  "error": {
    "message": "Invalid API key provided.",
    "type": "authentication_error",
    "code": 401
  }
}

Code	Signification	Solution
401	Clé API invalide ou manquante	Vérifie ta clé dans le header Authorization
403	Accès refusé (clé révoquée)	Génère une nouvelle clé depuis le dashboard
429	Trop de requêtes (rate limit)	Attends quelques secondes avant de réessayer
500	Erreur serveur interne	Réessaye — si ça persiste, contacte le support

Rate Limits

Pour garantir une performance optimale, l'API applique des limites de débit par clé.

Plan	Requêtes/min	Tokens/min	Latence moyenne
Standard	60 rpm	40 000 tpm	~23ms
Premium	300 rpm	200 000 tpm	~15ms

Les headers de réponse incluent X-RateLimit-Remaining et X-RateLimit-Reset pour monitorer ta consommation en temps réel.