Quickstart — generez votre premier examen en 5 minutes

Ce guide vous emmene de l'inscription au premier appel API avec reponse streamee. Aucune configuration prealable, aucun serveur a deployer.

1. 1

   Creez un compte developpeur

   Inscrivez-vous sur edugame.cc puis ouvrez votre dashboard. Le plan Decouverte suffit pour demarrer — aucune carte bancaire n'est requise pour les appels en lecture.

2. 2

   Generez votre cle API

   Ouvrez Developers > Cles API, cliquez 'Nouvelle cle'. Donnez-lui un nom (par ex. 'local-dev'), choisissez les scopes (preset 'Creator' recommande pour commencer) et copiez la cle. Elle n'est visible qu'une fois.

3. 3

   Exportez la cle dans votre shell

   Placez la cle dans une variable d'environnement : export EDUGAME_API_KEY=eg_live_xxx. Ne commitez jamais cette valeur dans Git.

4. 4

   Lancez votre premier appel

   Utilisez curl, le SDK TypeScript (npm i @edugame/sdk) ou Python (pip install edugame). L'endpoint POST /v1/exams accepte un objet JSON avec subject, level, topics et questionCount.

5. 5

   Lisez le stream SSE

   La reponse est un flux Server-Sent Events : chaque question generee apparait en temps reel avec son visuel. Une fois l'evenement 'done' recu, vous disposez de l'examen complet avec un examId utilisable pour recuperation ulterieure.

curl -N -X POST https://api.edugame.cc/v1/exams \
  -H "Authorization: Bearer $EDUGAME_API_KEY" \
  -H "Accept: text/event-stream" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "subject": "mathematiques",
    "level": "terminale",
    "topics": ["fonctions-exponentielles"],
    "questionCount": 5,
    "quality": "standard"
  }'

import { EduGame } from '@edugame/sdk'
import { logger } from './logger'

const client = new EduGame({ apiKey: process.env.EDUGAME_API_KEY })

const exam = await client.exams.generate({
  subject: 'mathematiques',
  level: 'terminale',
  topics: ['fonctions-exponentielles'],
  questionCount: 5,
  onEvent: (event) => logger.info({ type: event.type }, 'node received'),
})

logger.info({ examId: exam.id }, 'Exam ready')