Conseiller IA (streaming)

API Conseiller IA

Diffusez en continu des conseils d'expert sur vos projets dans les domaines du SEO, du design, des performances, de l'accessibilité, de la rédaction, de l'architecture, du marketing et de la sécurité. Chaque POST coûte CREDIT_COSTS.ADVISOR crédits et est limité à 20 requêtes par heure par clé API. Les administrateurs sont exemptés des charges de crédits.

Récupérer l'historique du conseiller

GET /api/v1/projects/{projectId}/advisor

Retourne la conversation chronologique du conseiller pour le projet.

{
  "data": {
    "history": [
      { "id": "msg_...", "role": "user", "content": "Audit my SEO" },
      { "id": "msg_...", "role": "assistant", "content": "## SEO Audit..." }
    ]
  }
}

Interroger le conseiller (streaming)

POST /api/v1/projects/{projectId}/advisor
Content-Type: application/json

{ "message": "Audit my homepage for accessibility issues" }

Retourne un flux text/plain. Les en-têtes de limite de débit sont envoyés avant le premier bloc afin que les clients puissent les analyser immédiatement. Les messages de plus de 5000 caractères sont rejetés avec une erreur VALIDATION_ERROR.

curl -N -X POST https://floop.tech/api/v1/projects/PRJ123/advisor \
  -H "Authorization: Bearer flp_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"message":"Review my copy"}'

En cas de crédits insuffisants, l'API retourne un 403 structuré afin que les clients appelant des outils puissent afficher le manque exact :

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Insufficient credits",
    "limit": {
      "blocked": true,
      "reason": "credit_limit",
      "required": 1,
      "available": 0,
      "cta": { "text": "Buy credits", "action": "buy_credits" }
    }
  }
}