Accueil
POST/api/v1/outils-ia/generer-description-produit

API Générateur de description produit

Rédige une à trois variantes de fiche produit e-commerce à partir du nom et des caractéristiques du produit.

Présentation

Cet endpoint transforme une liste de caractéristiques en descriptions commerciales soignées, dans le ton et la longueur de votre choix, avec plusieurs variantes à comparer.

Un modèle de langage hébergé par Websource rédige les descriptions à partir des informations fournies, sans en inventer d'autres. Vous choisissez le ton (professionnel, chaleureux, luxueux, fun, technique), la longueur (courte ≈ 50 mots, standard ≈ 120, détaillée ≈ 250) et le nombre de variantes (1 à 3). La réponse est une liste de textes, un par variante.

Pour enrichir un catalogue e-commerce (PrestaShop, WooCommerce, Shopify…), produire des fiches produit en masse depuis un fichier fournisseur, ou tester plusieurs tonalités avant de choisir. Relisez les descriptions : elles reposent uniquement sur les caractéristiques que vous avez fournies.

Utilisation pas à pas

  1. 1Envoyez le name (2 à 150 caractères) et les features (10 à 2 000 caractères).
  2. 2Ajoutez si besoin category, audience, tone, length et variantCount.
  3. 3Récupérez les variantes dans descriptions et choisissez celle qui convient.

Limites à connaître

  • Nom de 2 à 150 caractères, caractéristiques de 10 à 2 000, catégorie jusqu'à 100, public jusqu'à 200.
  • Traitement synchrone : prévoyez un délai d'attente généreux, plus long avec plusieurs variantes.

Endpoint et authentification

POSThttps://www.websource.fr/api/v1/outils-ia/generer-description-produit

Chaque requête porte votre jeton dans l'en-tête Authorization, et le corps est envoyé en JSON (Content-Type: application/json). Le jeton est gratuit, sur demande depuis votre compte (formulaire en bas de page).

Authorization: Bearer VOTRE_JETON

Paramètres du corps (JSON)

ParamètreTypeRequisDescription
namestringRequisNom du produit (2 à 150 caractères).
categorystringOptionnelCatégorie du produit (100 caractères max).
featuresstringRequisCaractéristiques principales (10 à 2 000 caractères).
audiencestringOptionnelPublic cible (200 caractères max).
tonestringOptionnel'professionnel', 'chaleureux', 'luxueux', 'fun' ou 'technique' — défaut 'professionnel'.
lengthstringOptionnel'courte' (~50 mots), 'standard' (~120 mots) ou 'detaillee' (~250 mots) — défaut 'standard'.
variantCountintOptionnel1, 2 ou 3 — défaut 2.

Exemples de code

Le même appel en plusieurs langages. Remplacez VOTRE_JETON par le jeton reçu par e-mail et gardez-le côté serveur (variable d'environnement), jamais dans un dépôt public.

curl -X POST https://www.websource.fr/api/v1/outils-ia/generer-description-produit \
  -H "Authorization: Bearer VOTRE_JETON" \
  -H "Content-Type: application/json" \
  -d '{"name":"Sac à dos Aventure 30L","category":"Bagagerie","features":"Imperméable, 30 litres, dos ventilé, compartiment ordinateur 15 pouces","tone":"chaleureux","length":"standard","variantCount":2}'

Réponses

Réponse en cas de succès (code 200) :

{
  "success": true,
  "descriptions": [
    "…variante 1…",
    "…variante 2…"
  ]
}
CodeSignificationQue faire
400Paramètre manquant ou invalideLisez le champ error, il précise la limite dépassée.
401Jeton absent, invalide ou révoquéVérifiez l'en-tête Authorization.
429Limite horaire atteinteAttendez l'échéance indiquée dans Retry-After.
503Service momentanément indisponibleRéessayez après quelques instants.

Toute erreur a la forme {"success": false, "error": "…"}. Limite par défaut : 60 requêtes par heure et par jeton (ajustable sur demande).

Demander un accès API

Gratuit. Un jeton vous est envoyé par e-mail une fois la demande approuvée. Il donne accès à tous les outils de cette API.

Pour demander un accès, connectez-vous ou créez un compte gratuit. Vous reviendrez ensuite directement sur ce formulaire.