Génération de Plans

New

Structurez vos idées avec l'IA

Transformez vos idées en plans structurés et professionnels. Notre service d'IA analyse votre sujet et génère automatiquement une structure logique et complète, adaptée à vos besoins.

Cas d'utilisation

Articles de blog

Cours & formations

Documentation technique

Business plans

Types de plans

Choisissez le niveau de détail adapté à vos besoins.

Simple

1 crédit

Plan basique avec titres de sections

type: "simple"

Détaillé

2 crédits

Sections avec sous-sections et descriptions

type: "detailed"

Complet

4 crédits

Plan exhaustif avec contenu suggéré

type: "comprehensive"

Endpoint principal

POST/v1/plans/generate

Génère un plan structuré à partir d'un sujet ou d'un contenu source.

Corps de la requête (JSON)

Nom	Type	Description
`topic`requis	string	Sujet ou titre du plan à générer. Peut être une phrase ou un paragraphe décrivant le besoin.
`type`	string	Niveau de détail : "simple", "detailed", "comprehensive". Défaut : detailed
`sections`	number	Nombre de sections principales souhaité (2-15). Défaut : auto
`language`	string	Langue de sortie (fr, en, es...). Défaut : détection auto
`context`	string	Contexte supplémentaire pour affiner la génération (audience cible, ton, etc.)
`source_content`	string	Contenu source à structurer (texte brut, notes, transcription...)
`format`	string	Format de sortie : "json", "markdown", "outline". Défaut : json

Réponse succès

200

{
  "success": true,
  "data": {
    "title": "Guide complet du marketing digital en 2024",
    "description": "Un plan détaillé couvrant les stratégies essentielles du marketing digital moderne.",
    "type": "detailed",
    "language": "fr",
    "sections": [
      {
        "id": "1",
        "title": "Introduction au marketing digital",
        "description": "Vue d'ensemble du paysage digital actuel",
        "subsections": [
          {
            "id": "1.1",
            "title": "Définition et enjeux",
            "key_points": [
              "Qu'est-ce que le marketing digital",
              "Pourquoi est-il incontournable",
              "Évolution depuis 2020"
            ]
          },
          {
            "id": "1.2", 
            "title": "Les canaux principaux",
            "key_points": [
              "Réseaux sociaux",
              "Email marketing",
              "SEO et SEA"
            ]
          }
        ]
      },
      {
        "id": "2",
        "title": "Stratégie de contenu",
        "description": "Comment créer et diffuser du contenu efficace",
        "subsections": [
          {
            "id": "2.1",
            "title": "Content marketing",
            "key_points": [
              "Définir sa ligne éditoriale",
              "Calendrier de publication",
              "Formats de contenu"
            ]
          }
        ]
      }
    ],
    "metadata": {
      "sections_count": 5,
      "subsections_count": 12,
      "estimated_reading_time": "45 min",
      "suggested_word_count": "8000-10000"
    }
  },
  "credits_used": 2,
  "credits_remaining": 48,
  "processing_time_ms": 2150
}

Exemples d'utilisation

Plan simple

Génération basique

bash

curl -X POST https://api.genesisai.fr/v1/plans/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "Introduction à React.js pour débutants",
    "type": "simple"
  }'

Plan détaillé avec contexte

Avec options avancées

bash

curl -X POST https://api.genesisai.fr/v1/plans/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "Comment lancer une startup tech",
    "type": "comprehensive",
    "sections": 8,
    "language": "fr",
    "context": "Audience : entrepreneurs débutants, ton : pratique et accessible"
  }'

Structurer un contenu existant

Idéal pour organiser des notes de réunion ou une transcription.

Depuis un contenu source

bash

curl -X POST https://api.genesisai.fr/v1/plans/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "Compte-rendu de réunion produit",
    "source_content": "Notes brutes de la réunion : Nous avons discuté du nouveau design... Les priorités pour Q1 sont... Jean a mentionné les problèmes de performance...",
    "type": "detailed"
  }'

Export Markdown

Format Markdown

bash

curl -X POST https://api.genesisai.fr/v1/plans/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "Architecture microservices",
    "type": "detailed",
    "format": "markdown"
  }'

Résultat :

# Architecture microservices

## 1. Introduction aux microservices
### 1.1 Définition et principes
- Qu'est-ce qu'un microservice
- Différences avec l'architecture monolithique
- Avantages et inconvénients

### 1.2 Quand adopter les microservices
- Critères de décision
- Cas d'usage appropriés

## 2. Conception et patterns
### 2.1 Domain-Driven Design
- Bounded contexts
- Agrégats et entités

### 2.2 Communication entre services
- REST vs gRPC vs Message queues
- Event sourcing

Intégration SDK

JavaScript / TypeScript

1import { GenesisAI } from '@genesisai/sdk';
2
3const client = new GenesisAI(process.env.API_KEY);
4
5// Génération simple
6const plan = await client.plans.generate({
7  topic: "Guide du télétravail efficace",
8  type: "detailed",
9  sections: 6
10});
11
12console.log(plan.title);
13console.log(plan.sections);
14
15// Export Markdown
16const markdown = await client.plans.generate({
17  topic: "Formation JavaScript moderne",
18  format: "markdown"
19});
20
21// Écriture dans un fichier
22fs.writeFileSync("plan.md", markdown.content);

Python

1from genesisai import GenesisAI
2import os
3
4client = GenesisAI(os.environ["API_KEY"])
5
6# Génération simple
7plan = client.plans.generate(
8    topic="Guide du télétravail efficace",
9    type="detailed",
10    sections=6
11)
12
13print(plan.title)
14for section in plan.sections:
15    print(f"- {section.title}")
16
17# Export Markdown
18markdown = client.plans.generate(
19    topic="Formation JavaScript moderne",
20    format="markdown"
21)
22
23with open("plan.md", "w") as f:
24    f.write(markdown.content)

Affiner un plan existant

Modifiez ou développez une section spécifique d'un plan généré.

POST/v1/plans/refine

Affine ou développe une section d'un plan existant.

Paramètres

Nom	Type	Description
`plan_id`requis	string	ID du plan original (retourné par /generate)
`section_id`requis	string	ID de la section à affiner (ex: '2' ou '2.1')
`action`requis	string	"expand" (développer), "simplify" (simplifier), "rewrite" (réécrire)
`instructions`	string	Instructions spécifiques pour l'affinement

Exemple d'affinement

bash

curl -X POST https://api.genesisai.fr/v1/plans/refine \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "plan_id": "plan_abc123",
    "section_id": "2",
    "action": "expand",
    "instructions": "Ajouter plus de détails sur les outils pratiques"
  }'

Bonnes pratiques

Soyez précis dans votre sujet

Plus votre description est détaillée, meilleur sera le plan généré. Incluez l'audience cible, le ton souhaité et les objectifs.

Utilisez le contexte

Le paramètre context permet d'affiner considérablement les résultats. Précisez le niveau technique, le format final (article, cours, présentation) et les contraintes.

Itérez sur vos plans

Utilisez l'endpoint /refine pour développer progressivement votre plan plutôt que de tout régénérer. C'est plus économique et préserve les bonnes parties.

Limites et tarification

Paramètre	Limite
Longueur topic	5000 caractères max
Longueur source_content	50000 caractères max
Sections maximum	15
Coût plan simple	1 crédit
Coût plan détaillé	2 crédits
Coût plan complet	4 crédits
Rate limit	30 requêtes / minute

Gestion des erreurs

Sujet trop vague

400

{
  "success": false,
  "error": {
    "code": "TOPIC_TOO_VAGUE",
    "message": "Le sujet fourni est trop vague pour générer un plan de qualité",
    "suggestion": "Ajoutez plus de détails sur le contexte, l'audience ou les objectifs"
  }
}

Plan non trouvé (pour /refine)

404

{
  "success": false,
  "error": {
    "code": "PLAN_NOT_FOUND",
    "message": "Le plan spécifié n'existe pas ou a expiré",
    "plan_id": "plan_abc123"
  }
}

Génération de Plans

Cas d'utilisation

Types de plans

Simple

Détaillé

Complet

Endpoint principal

Corps de la requête (JSON)

Réponse succès

Exemples d'utilisation

Plan simple

Plan détaillé avec contexte

Structurer un contenu existant

Export Markdown

Intégration SDK

JavaScript / TypeScript

Python

Affiner un plan existant

Paramètres

Bonnes pratiques

Soyez précis dans votre sujet

Utilisez le contexte

Itérez sur vos plans

Limites et tarification

Gestion des erreurs

Sujet trop vague

Plan non trouvé (pour /refine)

À explorer ensuite

Transcription Audio →

Limites & Quotas →