Products Manager APP

API Reference

API Enrichissement IA

Endpoints pour le pipeline d'enrichissement IA multi-provider : generation de contenu, images, traduction, extraction PDF et suivi des couts.

Base URL

https://api.productsmanager.app/api/v1/ai-enrichment

Pipeline d'enrichissement

MethodeEndpointDescription
POST/enrichEnrichir un produit (single)
POST/enrich/batchEnrichir un lot de produits
GET/enrich/batch/{batch_id}Statut d'un batch
POST/enrich/batch/{batch_id}/pauseMettre en pause
POST/enrich/batch/{batch_id}/resumeReprendre
DELETE/enrich/batch/{batch_id}Annuler un batch

Enrichir un produit

curl -X POST "https://api.productsmanager.app/api/v1/ai-enrichment/enrich" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "uuid",
    "fields": ["description", "seo_title", "seo_description", "bullet_points"],
    "provider": "openai",
    "model": "gpt-4o",
    "language": "fr",
    "tone": "professional"
  }'

Enrichissement batch

POST /api/v1/ai-enrichment/enrich/batch
{
  "product_ids": ["uuid-1", "uuid-2", "uuid-3"],
  "fields": ["description", "bullet_points"],
  "provider": "anthropic",
  "model": "claude-sonnet-4-20250514",
  "language": "fr",
  "max_concurrent": 5,
  "budget_limit_eur": 10.00
}

Le budget_limit_eur arrete automatiquement le batch quand le cout cumule atteint la limite. Les produits deja traites sont conserves.

Providers IA

MethodeEndpointDescription
GET/providersListe des providers configures
GET/providers/{id}Detail d'un provider
PUT/providers/{id}Mettre a jour la configuration
POST/providers/{id}/testTester la connexion

Providers supportes

ProviderModelesUsage
OpenAIgpt-4o, gpt-4o-miniDescriptions, SEO, bullet points
Anthropicclaude-sonnet-4-20250514, claude-haikuTraduction, analyse qualite
Ollamallama3, mistral (auto-heberge)Enrichissement local sans cout API

Web Enrichment Pipeline

Pipeline en 3 phases pour enrichir depuis des sources web externes.

MethodeEndpointDescription
POST/web-enrichLancer le pipeline web
GET/web-enrich/{job_id}Statut du job

Phases du pipeline

  1. Perplexity : Recherche contextuelle de donnees produit
  2. SerpAPI : Collecte de donnees structurees (fiches techniques, specs)
  3. Scraping : Extraction directe depuis pages produit
POST /api/v1/ai-enrichment/web-enrich
{
  "product_id": "uuid",
  "phases": ["perplexity", "serpapi", "scraping"],
  "max_sources": 5
}

Images IA

MethodeEndpointDescription
POST/images/generateGenerer une image produit
POST/images/enhanceAmeliorer une image existante
POST/images/remove-backgroundSuppression arriere-plan

Generer une image

POST /api/v1/ai-enrichment/images/generate
{
  "product_id": "uuid",
  "prompt": "Photo produit sur fond blanc, eclairage studio",
  "style": "product_photo",
  "size": "1024x1024"
}

Traduction

MethodeEndpointDescription
POST/translateTraduire les champs d'un produit
POST/translate/batchTraduction batch
POST /api/v1/ai-enrichment/translate
{
  "product_id": "uuid",
  "fields": ["description", "seo_title", "bullet_points"],
  "source_language": "fr",
  "target_languages": ["en", "de", "es"]
}

Qualite et scoring

MethodeEndpointDescription
GET/quality/{product_id}Score de qualite du contenu
POST/quality/analyzeAnalyser la qualite batch

Le score (0-100) evalue : completude, longueur description, presence SEO, images, attributs.

Suivi des couts

MethodeEndpointDescription
GET/usageResume consommation (jour/semaine/mois)
GET/usage/detailsDetail par provider et modele
GET/usage/budgetBudget restant

Exemple de reponse usage

{
  "period": "2026-03",
  "total_cost_eur": 45.32,
  "total_tokens": 1250000,
  "by_provider": {
    "openai": {"cost": 38.50, "requests": 420},
    "anthropic": {"cost": 6.82, "requests": 85}
  },
  "budget_limit_eur": 100.00,
  "budget_remaining_eur": 54.68
}

Prompt Library

MethodeEndpointDescription
GET/promptsListe des prompts (builtins + custom)
POST/promptsCreer un prompt custom
PATCH/prompts/{id}Modifier un prompt
DELETE/prompts/{id}Supprimer un prompt custom

20 prompts builtins fournis par defaut (non supprimables). Les prompts custom permettent de personnaliser le ton, le format et les instructions specifiques a votre catalogue.

Toutes les operations d'enrichissement sont loggees dans db_analytics.ai_usage_logs pour le suivi des couts et l'audit.

Ressources Associees