Profils de style

Les profils de style sont l'empreinte stylistique de ta marque, enregistrée sous forme de traits structurés (ton, formalité, longueur de phrase, vocabulaire, structure). Il existe deux façons de créer un profil : coller un texte ou importer un fichier directement, ou indiquer un domaine que le système explore pour en déduire le style. Un profil terminé est sélectionné lors de la génération d'article et s'intègre au prompt de rédaction comme une instruction — chaque article reste ainsi cohérent dans le ton, quel que soit qui ou quoi l'a généré.

Ce que ça permet

• Profil à partir d'un texte/fichier — colle un texte ou importe un fichier TXT/Markdown/DOCX/PDF, l'IA analyse le ton, la formalité, la longueur des phrases, le vocabulaire et la structure.
• Profil à partir d'un site web — indique un domaine, le système explore le sitemap (avec un crawl de la page d'accueil en repli) et analyse plusieurs sous-pages riches en contenu.
• Validation avant activation — les profils appris depuis une URL passent par une étape de relecture avant d'être réellement utilisés.
• Profil par défaut — marque un profil par équipe comme profil par défaut (dans l'interface sous /style-profiles).
• Réutilisable entre les modules — le même profil est sélectionnable pour les articles simples, l'éditeur d'article, les Storylines et l'Autopilot.

Quand l'utiliser

• Plusieurs auteurs ou des articles générés par IA doivent donner l'impression de venir de la même personne.
• Tu veux reprendre le style d'un site web existant sans devoir le décrire à la main.
• Un client ou une marque a un ton clairement reconnaissable qui doit être maintenu sur de nombreux articles.
• Tu construis un workflow automatisé (Autopilot, génération en masse) où personne ne vérifie manuellement le style de chaque article.

Workflow

1. Voir les profils existants — GET /projects/{project}/style-profiles liste tous les profils du projet.
2. Créer à partir d'un texte/fichier — se fait actuellement via l'interface sous /style-profiles : colle un texte ou importe un fichier, l'analyse tourne de façon asynchrone en arrière-plan (10 crédits), puis status: ready.
3. Créer à partir d'une URL — POST /projects/{project}/style-profiles/from-url avec {source_url, name?}. Le système vérifie d'abord si assez de crédits sont disponibles (sinon 402) ; avec suffisamment de crédits, l'analyse démarre de façon asynchrone, réponse 202 avec {id, status: 'pending', source_url, message}.
4. Interroger le statut — GET /style-profiles/{id}/scrape-status renvoie status, scraped_pages, failure_reason et pending_review pour le polling.
5. Relire le résultat — une fois l'analyse d'URL terminée (pending_review: true), soit POST /style-profiles/{id}/accept (conserver), soit POST /style-profiles/{id}/discard (rejeter — fonctionne uniquement tant que pending_review vaut encore true).
6. Créer un profil directement — POST /projects/{project}/style-profiles crée un profil de façon synchrone avec des données de style déjà disponibles ({name, description?, style_data?}), par exemple pour ta propre intégration qui a calculé le style elle-même. Aucun crédit débité.
7. Utiliser le profil — lors du démarrage d'un article (article simple, éditeur d'article, Storylines, Autopilot), choisis un profil avec status: ready ; le style est intégré automatiquement au prompt de rédaction.

API

Exemple de démarrage d'une analyse d'URL :

POST /v1/projects/42/style-profiles/from-url
{"source_url": "https://example.com", "name": "Style de example.com"}

Crédits & limites

• Apprentissage depuis une URL coûte 25 crédits — débités seulement après la réussite du job, pas au démarrage. Si l'analyse échoue avant que suffisamment de pages (au moins 5) aient été analysées avec succès, 0 crédit est débité.
• Apprentissage depuis un texte/fichier (via l'interface) coûte 10 crédits.
• Création directe via l'API avec des données de style déjà disponibles, ainsi que la liste, la mise à jour, la suppression et accept/discard, sont gratuits.
• L'analyse d'URL tourne de façon asynchrone et peut prendre 2 à 4 minutes ; suis la progression via le polling sur scrape-status.

Modules liés

• Storylines — les articles de storyline peuvent être générés avec le même profil de style que les articles simples.
• Automation — l'Autopilot utilise aussi un profil de style enregistré lors de la génération automatisée d'articles.
• AI Content Editor — l'éditeur d'article permet de choisir un profil de style pour les réécritures.