TEXT

L'API TEXT d'AlphaEdge vous permet de traiter et générer du texte. Cette fonctionnalité est optimisée pour offrir des performances élevées et une grande précision.

Cette page vous guide à travers l'utilisation de l'API TEXT, depuis les bases jusqu'aux cas d'usage avancés.

Voici un exemple minimal pour commencer avec l'API TEXT :

Exemple basique

from alphaedge import AlphaEdge

client = AlphaEdge(api_key="votre_cle_api")

# Génération de texte
response = client.text.generate(
    prompt="Explique le machine learning en 3 paragraphes",
    model="alphaedge-large-3"
)
print(response.text)

curl https://api.alphaedge-ai.com/v1/text \
  -H "Authorization: Bearer $ALPHAEDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alphaedge-large-3",
    "prompt": "Explique le machine learning en 3 paragraphes"
  }'

const AlphaEdge = require('@alphaedge/ai-sdk');

const client = new AlphaEdge({
  apiKey: process.env.ALPHAEDGE_API_KEY
});

// Génération de texte
const response = await client.text.generate({
  prompt: 'Explique le machine learning en 3 paragraphes',
  model: 'alphaedge-large-3'
});
console.log(response.text);

Voici les paramètres disponibles pour l'API TEXT :

L'API Text d'AlphaEdge accepte du texte en entrée sous différents formats :

Formats texte

• TXT (.txt) - Fichiers texte simples
• Markdown (.md, .markdown) - Texte formaté
• HTML (.html, .htm) - Contenu web (texte extrait)
• XML (.xml) - Données structurées
• JSON (.json) - Données JSON (extraction de valeurs texte)
• CSV (.csv) - Données tabulaires
• RTF (.rtf) - Rich Text Format

Documents

• PDF (.pdf) - Extraction du texte depuis PDF
• Word (.doc, .docx) - Documents Microsoft Word
• ODT (.odt) - Documents OpenDocument

Spécifications techniques

• Longueur maximale : 100 000 caractères par requête
• Tokens maximaux : 4096 tokens (prompt + réponse)
• Encodage : UTF-8 (recommandé)

Recommandations

• Pour les longs documents : Divisez en sections de 10 000 caractères maximum
• Pour de meilleurs résultats : Utilisez du texte bien formaté et structuré
• Évitez les caractères spéciaux non-UTF-8

L'API TEXT retourne une réponse au format JSON. Voici un exemple de structure de réponse :

{
  "id": "req_abc123",
  "object": "text.response",
  "created": 1677652288,
  "model": "alphaedge-text-3",
  "text": "Le texte généré...",
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 50,
    "total_tokens": 60
  }
}

Génération avec contraintes

Générez du texte avec des contraintes spécifiques :

response = client.text.generate(
    prompt="Rédige un article sur l'IA",
    model="alphaedge-large-3",
    max_tokens=500,
    temperature=0.7,
    stop=["Conclusion:", "En résumé"]
)
print(response.text)

Gestion des erreurs

Voici comment gérer les erreurs de manière appropriée :

from alphaedge import AlphaEdge, APIError

client = AlphaEdge(api_key="votre_cle_api")

try:
    response = client.text.generate(
        prompt="Votre prompt",
        model="alphaedge-large-3"
    )
    print(response)
except APIError as e:
    print(f"Erreur API: {e.message}")
    print(f"Code: {e.code}")
except FileNotFoundError:
    print("Fichier non trouvé")
except Exception as e:
    print(f"Erreur inattendue: {e}")

const AlphaEdge = require('@alphaedge/ai-sdk');

const client = new AlphaEdge({
  apiKey: process.env.ALPHAEDGE_API_KEY
});

try {
  const response = await client.text.generate({
    prompt: 'Votre prompt',
    model: 'alphaedge-large-3'
  });
  console.log(response);
} catch (error) {
  if (error instanceof AlphaEdge.APIError) {
    console.error(`Erreur API: ${error.message}`);
    console.error(`Code: ${error.code}`);
  } else if (error.code === 'ENOENT') {
    console.error('Fichier non trouvé');
  } else {
    console.error(`Erreur inattendue: ${error.message}`);
  }
}

Voici quelques cas d'usage courants pour l'API TEXT :

1. Génération de contenu

Créez du contenu textuel de qualité pour vos applications et sites web.

2. Résumé automatique

Résumez automatiquement de longs documents pour extraction d'informations clés.

3. Traduction et localisation

Traduisez et adaptez du contenu pour différents marchés.

Limitations

• Longueur maximale : 100 000 caractères par requête
• Formats supportés : TXT, Markdown, HTML, XML, JSON, CSV, RTF, PDF, Word, ODT
• Tokens maximaux : 4096 tokens (prompt + réponse)
• Rate limiting : 60 requêtes par minute par défaut (peut être augmenté selon votre plan)
• Tokens : Limite de 4096 tokens pour les prompts et réponses combinés
• Pages PDF : Maximum 100 pages par document

Bonnes pratiques

• Pour les longs documents : Divisez en sections de 10 000 caractères maximum
• Utilisez du texte bien formaté et structuré pour de meilleurs résultats
• Gérez les erreurs de manière appropriée avec des try/except
• Implémentez un système de retry pour gérer les erreurs temporaires
• Cachez les résultats lorsque c'est possible pour réduire les coûts
• Surveillez votre utilisation pour éviter de dépasser vos limites

Pour voir tous les modèles TEXT disponibles avec leurs spécifications détaillées, consultez la page Nos modèles et filtrez par type.