Quota et consommation de jetons IA
Cette ressource indique ce que votre projet IA peut encore dépenser. Les exécutions se mesurent en jetons, comptés sur un cycle de facturation, et les chiffres donnés ici sont ceux que vérifie le point d'accès des exécutions avant d'accepter un nouveau travail. Lisez-la avant de lancer un lot, et après un 402, pour savoir quand l'allocation repart à zéro.
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 https://api.ultineo.com/v1/ai/run-usage/summary \
-H "Authorization: Bearer sk-project-YOUR_KEY"{
"code": 200,
"title": "OK",
"response": {
"object": "usage",
"plan": {
"id": "plan_a1d9ffa770449a65ce8a",
"name": "essential",
"priority": "medium",
"model": "7 to 25B parameters",
"parallel": 2
},
"cycle": {
"start": 1788220800,
"end": 1790812800
},
"tokens": {
"bucket_included": 5000000,
"used": 148320,
"input": 141908,
"output": 6412,
"bucket_remaining": 4851680,
"purchased_active": 0,
"purchased_remaining": 0,
"available": 4851680
},
"runs": {
"total": 217,
"finished": 203,
"failed": 6,
"pending": 8
}
}
}L'objet usage
| Champ | Type | Description |
|---|---|---|
object | chaîne | Toujours usage. |
plan | objet | Le forfait de votre projet. |
cycle | objet | Le cycle de facturation sur lequel les jetons sont mesurés. |
tokens | objet | L'allocation et la consommation de jetons. |
runs | objet | Le nombre d'exécutions, par statut. |
plan
| Champ | Type | Description |
|---|---|---|
id | chaîne | L'identifiant du forfait, préfixé plan_. |
name | chaîne | Le nom du forfait. |
priority | chaîne | La priorité de votre projet dans la file d'attente : low, medium ou high. |
model | chaîne | Les tailles de modèle que le forfait ouvre, par exemple 7 to 25B parameters. |
parallel | entier | Le nombre d'exécutions que votre projet peut avoir en cours en même temps : 1 pour low, 2 pour medium, 5 pour high. |
cycle
| Champ | Type | Description |
|---|---|---|
start | entier | Le début du cycle en cours, en secondes Unix. |
end | entier | Sa remise à zéro, en secondes Unix. |
Le cycle est un mois glissant qui commence à la date d'activation de votre forfait : il ne correspond donc généralement pas à un mois calendaire. Un projet sans date d'activation suit le mois calendaire. À end, used revient à zéro.
tokens
| Champ | Type | Description |
|---|---|---|
bucket_included | entier | Les jetons inclus dans le forfait pour chaque cycle. |
used | entier | Les jetons consommés pendant ce cycle, entrée et sortie comprises. |
input | entier | La part entrée de used. |
output | entier | La part sortie de used. |
bucket_remaining | entier | Ce qui reste de l'allocation propre au forfait, jamais en dessous de zéro. |
purchased_active | entier | Les jetons détenus en crédit supplémentaire actuellement valable. |
purchased_remaining | entier | Ce qui reste de ce crédit. |
available | entier | Ce que votre projet peut réellement encore dépenser. |
available est le chiffre qui compte : il ajoute ce qui reste de l'allocation du forfait au crédit supplémentaire restant, et c'est lui que teste le point d'accès des exécutions. Quand il atteint zéro, POST /v1/ai/run/create est refusé avec 402 et Your reasoning quota is exhausted. Please wait until it resets or upgrade your plan.
Astuce — Comparez
availableà la taille attendue de votre lot avant de commencer, plutôt que de découvrir la limite à mi-chemin. Une exécution refusée n'est jamais mise en file d'attente : rien n'est dépensé à moitié.
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 le cycle en cours.
Remarque —
pendingest le compteur à surveiller face àplan.parallel. Quand il atteint la limite, les nouvelles exécutions sont toujours acceptées mais attendent leur tour.