Intégrez TokenTrace
en 30 secondes.

POST /api/track

Enregistre un usage de tokens et retourne le CO₂ calculé avec des équivalences concrètes.

Corps de la requête (JSON)

Exemple de réponse 200 OK

{
  "success": true,
  "co2_grams": 3.45,
  "model": "GPT-4",
  "tokens": 1500,
  "equivalences": {
    "km_voiture": 0.023,
    "smartphone_charges": 0.43
  }
}

Exemples d'intégration

curl -X POST https://tokentrace.nanocorp.app/api/track \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ttk_votre_cle_api" \
  -d '{
    "model": "gpt-4",
    "tokens": 1500,
    "metadata": {
      "user_id": "usr_123",
      "feature": "chat-completion"
    }
  }'

Facteurs d'émission

Chaque modèle dispose d'un facteur CO₂ par token basé sur la consommation électrique estimée des data centers et les facteurs d'émission 2024.

* Estimations basées sur la consommation électrique des data centers et les intensités carbone moyennes (2024). Les chiffres réels varient selon la localisation des serveurs et le mix énergétique.

GET /api/stats

Retourne les statistiques globales d'émissions : total CO₂, nombre de requêtes, tokens traités, et répartition par modèle.

Exemple de réponse

{
  "success": true,
  "global": {
    "total_co2_grams": 124.83,
    "total_requests": 42,
    "total_tokens": 58700
  },
  "by_model": [
    {
      "model": "GPT-4",
      "provider": "OpenAI",
      "requests": 28,
      "total_tokens": 43200,
      "total_co2_grams": 99.36
    },
    {
      "model": "Claude 3 Opus",
      "provider": "Anthropic",
      "requests": 14,
      "total_tokens": 15500,
      "total_co2_grams": 31.00
    }
  ]
}