NeuraAPI

Documentation API

Référence complète de l'API NeuraAPI. Authentifiez-vous, appelez les endpoints, intégrez l'IA dans votre application en quelques minutes.

Démarrage rapide

Installez le SDK et faites votre premier appel API en 3 lignes.

npm install @neuraapi/sdk
import { NeuraAPI } from '@neuraapi/sdk'

const ai = new NeuraAPI('napi_votre_cle_ici')
const result = await ai.generate({ prompt: 'Bonjour le monde' })
console.log(result.content)

Authentification

Toutes les requêtes API nécessitent une clé API dans l'en-tête HTTP x-api-key. Obtenez votre clé gratuitement après inscription sur /register.

curl -X POST https://ai-empire-steel.vercel.app/api/ai/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: napi_votre_cle_ici" \
  -d '{"prompt": "Bonjour le monde"}'

Endpoints

4 endpoints IA disponibles. Chaque requête consomme des crédits selon la complexité.

POST/api/ai/generate

Génère du texte à partir d'un prompt. Idéal pour la création de contenu, les réponses de chatbot, les résumés.

Paramètres

NomTypeRequisDescription
promptstringrequisLe texte ou l'instruction pour guider la génération
maxTokensnumberoptionnelNombre maximum de tokens à générer (défaut: 1000)
modelstringoptionnelModèle IA à utiliser (défaut: groq-llama)

Exemples de code

curl -X POST https://ai-empire-steel.vercel.app/api/ai/generate \
  -H "Content-Type: application/json" \
  -H "x-api-key: napi_votre_cle_ici" \
  -d '{
  "prompt": "Écris un paragraphe sur les bienfaits de l'automatisation",
  "maxTokens": 500
}'

Réponse

{
  "content": "L'automatisation permet aux entreprises de gagner en productivité...",
  "tokensUsed": 120,
  "model": "groq-llama-3.3-70b"
}

Essayer l'API

Testez l'endpoint de génération de texte directement dans votre navigateur. Entrez un prompt et voyez le résultat en temps réel.

POST/api/ai/generatePlayground démo

Ce playground utilise un quota démo limité. Créez un compte gratuit pour un accès complet.

Codes d'erreur

Référence des codes de réponse HTTP retournés par l'API.

400Requête invalide

Le body de la requête est mal formaté ou manque de champs requis. Vérifiez le JSON envoyé.

401Non autorisé

Votre clé API est invalide ou manquante. Incluez l'en-tête x-api-key avec une clé commençant par napi_.

402Crédits insuffisants

Vous avez épuisé vos crédits mensuels. Passez au plan Pro ou attendez le renouvellement mensuel.

429Trop de requêtes

Limite de requêtes par minute atteinte. Attendez quelques secondes ou passez à un plan supérieur.

500Erreur serveur

Erreur interne du serveur. Réessayez dans quelques instants. Si le problème persiste, contactez le support.

Limites et quotas

Chaque plan inclut un quota de crédits mensuels et une limite de requêtes par minute (RPM).

PlanCrédits/moisRequêtes/minuteIdéal pour
Starter100/mois10Pour tester et expérimenter
Pro10 000/mois60Pour les projets en production
EnterpriseIllimitéIllimitéPour les entreprises et agences

Consommation de crédits par endpoint

generate (texte)1 crédit
chat (conversation)1 crédit
seo (contenu SEO)2 crédits
code (génération)3 crédits

Prêt à construire ?

Créez un compte gratuit et obtenez votre clé API en quelques secondes.

Obtenir une clé API gratuite