For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/fr/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/fr/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/fr/guides/public-cloud/ai-machine-learning/ai-ecosystem-lettria-billing-features.md.

AI Partners Ecosystem - Lettria - Fonctionnalités des modèles, capacités et facturation

Voir en Markdown

Découvrez le fonctionnement des modèles Lettria et de leur facturation

Objectif

OVHcloud propose différents services d'Intelligence Artificielle grâce à son AI Partners Ecosystem. Vous bénéficierez d'un catalogue d'applications prêtes à l'emploi fournies par nos partenaires, que vous pourrez facilement déployer selon vos besoins grâce à AI Deploy.

Lettria est un partenaire OVHcloud qui propose des services d'IA dédiés au texte. Ce guide vous présentera les fonctionnalités des modèles Lettria, leur fonctionnement ainsi que la facturation associée.

Introduction

Lettria est une start-up spécialisée dans le NLP (traitement du langage naturel). La plateforme permet à toutes les organisations, des start-ups aux grands groupes, d'effectuer une analyse textuelle de leurs données afin de prendre les meilleures décisions stratégiques.

Lettria propose des modèles de compréhension du texte qui permettent aux utilisateurs d'identifier et d'extraire facilement les informations clés de leurs textes. Cette méthode s'appuie sur l'intelligence artificielle et les techniques de NLP pour extraire les sentiments, les émotions et les entités d'un texte.

Les usages sont nombreux :

  • Automatisation du service client
  • Suivi des réseaux sociaux
  • Modération de contenu
  • Classification de texte

Fonctionnalités des modèles Lettria

Les modèles Lettria disponibles chez OVHcloud couvrent trois tâches de NLP : l'analyse de sentiment, l'extraction d'émotion et la reconnaissance d'entités nommées.

Sentiment

Lettria vous permet d'analyser les sentiments d'un texte. Le principe consiste à classer automatiquement les données textuelles comme positives, négatives ou neutres en fonction du sentiment sous-jacent exprimé dans le texte.

Exemple d'entrée :

I love Lettria and OVHcloud!

Exemple de sortie :

{"type":"positive","score":0.893}
LettriaSentimentExample
Info

Pour en savoir plus sur le modèle d'analyse de sentiment de Lettria, reportez-vous à cette documentation.

Émotion

Lettria vous permet d'extraire les émotions d'une donnée textuelle. L'objectif est de classer automatiquement la donnée textuelle en fonction des émotions qu'elle véhicule : joie, tristesse, colère, peur, ...

Exemple d'entrée :

I love Lettria and OVHcloud!

Exemple de sortie :

{"type":"love","confidence":0.99}
{"type":"admiration","confidence":0.65}
{"type":"joy","confidence":0.585}
LettriaEmotionExample
Info

Pour en savoir plus sur le modèle d'extraction d'émotion de Lettria, reportez-vous à cette documentation.

Reconnaissance d'entités nommées

Lettria vous permet d'extraire les entités d'un texte. Le principe consiste à identifier et classer automatiquement les entités clés telles que les lieux (LOC), les personnes (PER), les organisations (ORG) et les entités diverses (MISC) dans un texte.

Exemple d'entrée :

John is using Lettria app for NER task.

Exemple de sortie :

{
   "predictions":[
      [
         {
            "entity":"PER",
            "score":0.834,
            "confidence":0.673,
            "words":"John",
            "start":0,
            "end":4
         },
         {
            "entity":"MISC",
            "score":0.941,
            "confidence":0.919,
            "words":"Lettria",
            "start":14,
            "end":21
         }
      ]
   ],
   "analysed_chars":32
}
LettriaNERExample
Info

Pour en savoir plus sur le modèle NER de Lettria, reportez-vous à cette documentation.

Démarrage rapide avec Lettria

Pour pouvoir interroger les modèles Lettria, vous devez d'abord déployer l'une des images Lettria avec AI Deploy.

Dans cet exemple, nous nous appuierons sur l'extraction d'émotions d'un texte.

Lancer une app Lettria

Pour lancer une app AI Deploy, plusieurs possibilités s'offrent à vous. Vous pouvez le faire depuis l' ou via la CLI ovhai.

Lancer une app depuis l'OVHcloud Control Panel

Pour lancer votre app Lettria depuis l'interface, vous devez renseigner certaines informations :

  • Emplacement
  • Application à déployer - dans cet exemple, nous choisissons l'image "emotions" compatible GPU
LettriaDeployment
Warning

Faites attention au choix de l'image, en fonction des ressources requises.

Pour une app GPU, choisissez l'image Lettria contenant gpu dans son tag, puis choisissez un ou plusieurs GPU comme ressources. Le même principe de fonctionnement s'applique également pour les apps CPU.

  • Ressources - nous vous conseillons d'utiliser 1 GPU
  • Configurer votre app - ajoutez un label si vous avez choisi un accès restreint
Info

Pour savoir comment lancer une app depuis l', reportez-vous à ce guide.

Lancer une app avec la CLI ovhai

Vous pouvez également démarrer cette app avec la CLI ovhai en exécutant la commande suivante :

ovhai app run \
    --gpu 1 \
    --label <name=value> \
    --partner lettria \
    emotion-analysis:v0.1.0-gpu
Info

Remplacez <label=name> par les variables correspondant à votre token. Pour en savoir plus sur la gestion du token, reportez-vous à cette documentation.

Accéder à vos apps Lettria

Une fois l'app lancée et au statut RUNNING, vous pouvez copier l'URL et accéder à votre app. Vous serez alors redirigé et pourrez interagir avec l'API Lettria.

LettriaApi

Interroger les modèles Lettria

Vous pouvez désormais interroger les modèles Lettria sur les sentiments ou émotions de votre texte.

Info

Dans l'exemple suivant, nous nous concentrerons sur le modèle qui extrait les émotions d'un texte. Pour plus d'informations détaillées sur les modèles Lettria, reportez-vous à cette documentation.

Générer une requête cURL

Maintenant que votre app Lettria est lancée avec AI Deploy, vous êtes prêt à interroger les modèles d'IA.

Vous pouvez utiliser l'exemple suivant avec les paramètres suivants :

  • url de l'app - remplacez <app_url> par la vôtre
  • token d'accès (puisque nous sommes en accès restreint) - remplacez <your_token_bearer> par le vôtre
  • format des données
  • données à traiter (texte)
curl --request POST \
    --url <app_url>/predict \
    -H "Authorization: Bearer <your_token_bearer>" \
    --header 'Content-Type: application/json' \
    --data '["Congratulations! You have successfully launched your Lettria app."]'

Résultat :

[{"type":"gratitude","confidence":0.936,"detail":{"gratitude":0.936,"admiration":0.921,"pride":0.861,"joy":0.701,"excitement":0.689,"amusement":0.306,"caring":0.244,"approval":0.239,"optimism":0.207,"relief":0.168,"neutral":0.154,"surprise":0.148,"realization":0.081,"curiosity":0.07,"love":0.06,"desire":0.04,"anger":0.04,"annoyance":0.035,"fear":0.019,"embarrassment":0.017,"disappointment":0.017,"disapproval":0.014,"confusion":0.014,"grief":0.013,"sadness":0.012,"disgust":0.011,"nervousness":0.005,"remorse":0.004}}]

Générer une requête Python

Si vous souhaitez interroger l'API Lettria avec Python, cet exemple de code utilisant la bibliothèque Python Request peut vous convenir :

import requests
import json
from requests.structures import CaseInsensitiveDict

url = "<app_url>/predict"

headers = CaseInsensitiveDict()
headers = {'content-type': 'application/json',
           'Accept-Charset': 'UTF-8',
           'Authorization': 'Bearer <your_token_bearer>'}

j_data = json.dumps(["Congratulations! You have successfully launched your Lettria app."])
r = requests.post(url, data = j_data, headers = headers)

print(r.text)

Résultat :

[{"type":"gratitude","confidence":0.936,"detail":{"gratitude":0.936,"admiration":0.921,"pride":0.861,"joy":0.701,"excitement":0.689,"amusement":0.306,"caring":0.244,"approval":0.239,"optimism":0.207,"relief":0.168,"neutral":0.154,"surprise":0.148,"realization":0.081,"curiosity":0.07,"love":0.06,"desire":0.04,"anger":0.04,"annoyance":0.035,"fear":0.019,"embarrassment":0.017,"disappointment":0.017,"disapproval":0.014,"confusion":0.014,"grief":0.013,"sadness":0.012,"disgust":0.011,"nervousness":0.005,"remorse":0.004}}]

Concept de facturation Lettria

La tarification de Lettria diffère légèrement de l'offre AI Deploy classique. Pour mieux comprendre votre facture, nous détaillons l'offre ci-dessous.

Info

Le coût total de votre app inclura le prix des ressources sélectionnées ainsi que le prix de la licence du modèle partenaire.

Gardez à l'esprit que les modèles Lettria sont facturés au paiement à l'usage. Nous ne proposons pas encore de facturation au paiement à l'appel.

Estimer le coût d'une app Lettria

Comment calculer le coût total d'une app Lettria ?

Le prix total se compose de deux parties distinctes :

  • Prix des ressources
  • Prix de la licence du modèle Lettria

Prix des ressources

La première étape consiste à calculer le prix d'une app AI Deploy en fonction des ressources de calcul choisies.

Gardez à l'esprit que la facturation se fait à la seconde, bien que le prix soit affiché à l'heure HT pour plus de lisibilité.

Info

Pour lancer votre app, vous pouvez choisir entre deux types de ressources : CPU ou GPU. Le prix variera donc en fonction de la ressource choisie.

Resources price = (nb app) x (nb resources) x (nb replicas) x [ (unit price per hour HT) x (nb hour) ]

Pour en savoir plus sur le coût de base d'une app lancée avec AI Deploy, reportez-vous à cette documentation.

Prix de la licence du modèle Lettria

La seconde étape consiste à calculer le coût de l'un des services partenaires Lettria en fonction de la ressource choisie.

Lettria model licensing price = (nb app) x (nb resources) x (nb replicas) x [ (Lettria model licensing unit price per hour for specified resource type) x (nb hour) ]

Prix total

Pour obtenir le coût total d'une app Lettria lancée avec AI Deploy, additionnez les deux montants obtenus lors des calculs précédents :

Total price = Resources price + Lettria model licencing price
LettriaBilling
Info

Pour en savoir plus sur le coût de base (prix des ressources) d'une app lancée avec AI Deploy, reportez-vous à cette documentation.

Reportez-vous au site OVHcloud Public Cloud pour toutes les informations concernant les prix des ressources et des modèles partenaires.

Exemples

Exemple 1 : app 1 GPU pendant 10 heures puis suppression

Nous déployons une app Lettria avec AI Deploy, avec 1 GPU, et nous la laissons tourner pendant 10 heures avant de la supprimer.

Vous recevez des milliers d'appels : c'est inclus (pas de facturation au paiement à l'appel, vous payez le calcul en cours d'exécution).

  • ressources de calcul par réplica : 1 x GPU NVIDIA V100s (1,93€ /heure /gpu)
  • scaling : fixe
  • réplicas : 1
  • nombre d'appels : illimité
  • durée : 10 heures puis suppression
  • service lettria : 1 x service Lettria pour l'utilisation GPU (2,50€ /heure /gpu)

Calcul du prix pour le calcul : 1,93€ (prix /heure /gpu) x 1 (gpu) x 1 (réplica) x 10 (heures) = 19,30€ Calcul du prix pour le service Lettria : 2,50€ (prix lettria /heure /gpu) x 1 (gpu) x 1 (réplica) x 10 (heures) = 25,00€

Calcul du prix total : 19,30€ + 25,00€ = 44,30€

Exemple 2 : 2 CPU et autoscaling

Déployez une app Lettria avec 1 CPU, choisissez une configuration d'autoscaling avec 1 réplica minimum et 3 réplicas maximum.

Vous recevez des milliers d'appels : c'est inclus (pas de facturation au paiement à l'appel, vous payez le calcul en cours d'exécution).

  • ressources de calcul par réplica : 2 x CPU (0,03€ /heure /cpu)
  • scaling : auto-scaling, de 1 à 3 réplicas
  • nombre d'appels : illimité
  • durée : 5 heures avec 1 réplica en cours d'exécution, puis un pic d'1 heure à 3 réplicas, puis arrêt et suppression.
  • service lettria : 2 x services Lettria pour l'utilisation CPU (1,50€ /heure /cpu)

Calcul du prix pour le calcul (il variera dans le temps en raison de l'auto-scaling) :

0,03€ (prix /heure /cpu) x 2 (cpus) x 1 (réplica) x 5 (heures) = 0,30€ + 0,03€ (prix /heure /cpu) x 2 (cpus) x 3 (réplicas) x 1 (heure) = 0,18€

Le total pour le calcul est de 0,48€.

Calcul du prix pour le service Lettria (il variera dans le temps en raison de l'auto-scaling) :

1,50€ (prix lettria /heure /cpu) x 2 (cpus) x 1 (réplica) x 5 (heures) = 15,00€ + 1,50€ (prix lettria /heure /cpu) x 2 (cpus) x 3 (réplicas) x 1 (heure) = 9,00€

Le total pour le service Lettria est de 24,00€.

Calcul du prix total : 0,48€ + 24,00€ = 24,48€

Nous voulons vos retours !

N’hésitez pas à nous faire part de vos questions, retours et suggestions pour améliorer le service :

Cette page vous a-t-elle aidé ?