Générations IA et travaux

Déroulement

1. Lancez la génération : 202, avec jobId et l’estimation des crédits IA (estimate.units, en-tête Memojin-Credits-Estimate).
2. Interrogez le travail toutes les 5 secondes environ : pending, puis running (avec progress de 0 à 100).
3. À succeeded, listez les cartes ou les questions du contenu. À failed (error: "generation_failed") ou cancelled, rien n’est à lire ; citez l’identifiant du travail si vous nous écrivez.

La boucle complète

import os, time, uuid, requests

API = "https://api.memojin.com/v1"
H = {"Authorization": f"Bearer {os.environ['MEMOJIN_API_KEY']}"}

# 1. Start the generation: 202 Accepted
job = requests.post(
    f"{API}/contents/{content_id}/memocard-generations",
    headers={**H, "Idempotency-Key": str(uuid.uuid4())},
    timeout=30,
)
job.raise_for_status()
job = job.json()  # {"jobId": ..., "status": "pending", "estimate": {"operation": "ai_card", "units": 12}}

# 2. Poll the job every 5 seconds until it is finished
while True:
    state = requests.get(f"{API}/jobs/{job['jobId']}", headers=H, timeout=10).json()
    if state["status"] in ("succeeded", "failed", "cancelled"):
        break
    time.sleep(5)

# 3. Read the memocards of the content
if state["status"] == "succeeded":
    cards = requests.get(f"{API}/contents/{content_id}/memocards", params={"limit": 100}, headers=H, timeout=30).json()["data"]

Refus avant toute génération

• 422 content_too_short : le texte du contenu fait moins de 100 caractères.
• 422 nothing_to_generate : chaque partie du contenu a déjà ses cartes mémo.
• 422 no_memocards : le contenu n’a pas de carte mémo d’où tirer des questions.
• 422 all_memocards_have_questions : chaque carte a déjà ses questions.
• 402 insufficient_credits : le compte n’a plus assez de crédits IA.

En bac à sable

Avec une clé mj_test_, la génération est simulée : travail aussitôt succeeded, aucune carte créée, aucun crédit consommé (voir bac à sable). La fin d’un travail signalée par webhook Bientôt.

L’objet GenerationAccepted

Une génération acceptée pour un traitement asynchrone.

{
  "jobId": "9b8a7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
  "status": "pending",
  "estimate": {
    "operation": "ai_card",
    "units": 12
  }
}

L’objet Job

Un travail asynchrone (une génération IA).

{
  "id": "9b8a7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
  "type": "memocard_generation",
  "status": "running",
  "progress": 40,
  "contentId": "3f1c2b0e-8d4a-4f7e-9a51-3c2d1e0f9b87",
  "error": null,
  "createdAt": "2026-10-04T10:00:00.000Z",
  "updatedAt": "2026-10-04T10:00:20.000Z"
}

Générer des cartes mémo à partir d’un contenu

Génère des cartes mémo à partir des parties du corps du contenu qui n’en ont pas encore. Asynchrone : répond 202 avec un jobId à interroger par GET /v1/jobs/{jobId}. Consomme les crédits IA du compte (une unité ai_card par carte mémo, voyez estimate.units et l’en-tête Memojin-Credits-Estimate) ; 402 insufficient_credits quand ils sont épuisés. Refus métier : 422 content_too_short, 422 nothing_to_generate. Avec une clé mj_test_, rien n’est généré et aucun crédit n’est consommé.

Paramètres

Réponse 202

Génération acceptée — Un objet GenerationAccepted

Erreurs

curl -X POST "https://api.memojin.com/v1/contents/3f1c2b0e-8d4a-4f7e-9a51-3c2d1e0f9b87/memocard-generations" \
  -H "Authorization: Bearer $MEMOJIN_API_KEY" \
  -H "Idempotency-Key: 6f1c2b0e-8d4a-4f7e-9a51-3c2d1e0f9b87"

{
  "jobId": "9b8a7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
  "status": "pending",
  "estimate": {
    "operation": "ai_card",
    "units": 12
  }
}

Générer des questions à partir d’un contenu

Génère des questions d’entraînement pour les cartes mémo du contenu qui n’en ont pas encore. Asynchrone : répond 202 avec un jobId à interroger par GET /v1/jobs/{jobId}. Consomme les crédits IA du compte (une unité ai_card par question, voyez estimate.units et l’en-tête Memojin-Credits-Estimate) ; 402 insufficient_credits quand ils sont épuisés. Refus métier : 422 no_memocards, 422 all_memocards_have_questions. Avec une clé mj_test_, rien n’est généré et aucun crédit n’est consommé.

Paramètres

Réponse 202

Génération acceptée — Un objet GenerationAccepted

Erreurs

curl -X POST "https://api.memojin.com/v1/contents/3f1c2b0e-8d4a-4f7e-9a51-3c2d1e0f9b87/question-generations" \
  -H "Authorization: Bearer $MEMOJIN_API_KEY" \
  -H "Idempotency-Key: 6f1c2b0e-8d4a-4f7e-9a51-3c2d1e0f9b87"

{
  "jobId": "9b8a7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
  "status": "pending",
  "estimate": {
    "operation": "ai_card",
    "units": 12
  }
}

Lire un travail

État et avancement d’une génération asynchrone. Interrogez-le toutes les quelques secondes (5 s est un bon rythme) jusqu’à ce que status vaille succeeded, failed ou cancelled ; listez ensuite les cartes mémo ou les questions du contenu.

Paramètres

Réponse 200

Le travail — Un objet Job

Erreurs

curl "https://api.memojin.com/v1/jobs/9b8a7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d" \
  -H "Authorization: Bearer $MEMOJIN_API_KEY"

{
  "id": "9b8a7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
  "type": "memocard_generation",
  "status": "running",
  "progress": 40,
  "contentId": "3f1c2b0e-8d4a-4f7e-9a51-3c2d1e0f9b87",
  "error": null,
  "createdAt": "2026-10-04T10:00:00.000Z",
  "updatedAt": "2026-10-04T10:00:20.000Z"
}