ULTINEO

Consommation de jetons IA et tarif

Cette ressource indique ce que votre projet IA a consommé sur la semaine de facturation en cours et le montant correspondant. Les exécutions se mesurent en jetons et sont tarifées au jeton : il n'y a ni forfait, ni allocation, ni pack, et une exécution n'est donc jamais refusée pour cause de consommation.

Points d'accès

MéthodeCheminDroit
GET/v1/ai/run-usage/summaryusage:read

Le point d'accès ne prend aucun paramètre.

Lire le résumé

curl
curl https://api.ultineo.com/v1/ai/run-usage/summary \
  -H "Authorization: Bearer sk-project-YOUR_KEY"
application/json
{
  "code": 200,
  "title": "OK",
  "response": {
    "object": "usage",
    "period": { "start": 1794182400, "end": 1794787199 },
    "price": { "currency": "EUR", "unit": 1000000, "input": 1, "output": 5 },
    "tokens": { "input": 842000, "output": 311500, "used": 1153500, "available": 2000000000 },
    "amount": 2.4,
    "runs": { "total": 1840, "finished": 1795, "failed": 31, "pending": 14 }
  }
}

L'objet usage

ChampTypeDescription
objectchaîneToujours usage.
periodobjetLa semaine de facturation couverte par les chiffres.
priceobjetLe prix au jeton.
tokensobjetLes jetons consommés sur la période.
amountnombreLes jetons de la période au prix, dans la devise du prix.
runsobjetLes totaux d'exécutions de votre projet.

period

ChampTypeDescription
startentierLundi 00:00:00 UTC de la semaine en cours, en secondes Unix.
endentierDimanche 23:59:59 UTC de la semaine en cours, en secondes Unix.

price

ChampTypeDescription
currencychaîneEUR. Les prix s'entendent hors TVA.
unitentierLe nombre de jetons auquel s'appliquent les deux prix : 1000000.
inputnombrePrix de unit jetons en entrée.
outputnombrePrix de unit jetons en sortie.

tokens

ChampTypeDescription
inputentierJetons en entrée des exécutions de la période.
outputentierJetons en sortie des exécutions de la période.
usedentierinput plus output.
availableentierUne constante, très au-dessus de toute consommation. Conservée pour les clients écrits quand une allocation existait ; ne vous appuyez pas dessus.

Les exécutions terminées sur une erreur sont exclues des trois compteurs et de amount.

runs

ChampTypeDescription
totalentierToutes les exécutions que votre projet a lancées.
finishedentierLes exécutions terminées.
failedentierLes exécutions terminées sur une erreur.
pendingentierLes exécutions encore en file d'attente ou en cours.

Ces quatre chiffres portent sur toute la vie de votre projet, et non sur la semaine en cours.