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éthode | Chemin | Droit |
|---|---|---|
| GET | /v1/ai/run-usage/summary | usage: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
| Champ | Type | Description |
|---|---|---|
object | chaîne | Toujours usage. |
period | objet | La semaine de facturation couverte par les chiffres. |
price | objet | Le prix au jeton. |
tokens | objet | Les jetons consommés sur la période. |
amount | nombre | Les jetons de la période au prix, dans la devise du prix. |
runs | objet | Les totaux d'exécutions de votre projet. |
period
| Champ | Type | Description |
|---|---|---|
start | entier | Lundi 00:00:00 UTC de la semaine en cours, en secondes Unix. |
end | entier | Dimanche 23:59:59 UTC de la semaine en cours, en secondes Unix. |
price
| Champ | Type | Description |
|---|---|---|
currency | chaîne | EUR. Les prix s'entendent hors TVA. |
unit | entier | Le nombre de jetons auquel s'appliquent les deux prix : 1000000. |
input | nombre | Prix de unit jetons en entrée. |
output | nombre | Prix de unit jetons en sortie. |
tokens
| Champ | Type | Description |
|---|---|---|
input | entier | Jetons en entrée des exécutions de la période. |
output | entier | Jetons en sortie des exécutions de la période. |
used | entier | input plus output. |
available | entier | Une 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
| Champ | Type | Description |
|---|---|---|
total | entier | Toutes les exécutions que votre projet a lancées. |
finished | entier | Les exécutions terminées. |
failed | entier | Les exécutions terminées sur une erreur. |
pending | entier | Les 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.