Quota et consommation de tokens

Cette ressource indique ce que le projet peut encore dépenser. Les exécutions sont comptées en tokens, sur un cycle de facturation, et les chiffres présentés ici sont exactement ceux que l'appel d'exécution vérifie avant d'accepter un nouveau travail. Lisez-la avant de lancer un lot, et après un 402, pour savoir quand le quota se réinitialise.

Les appels

Méthode	Chemin	Droit requis
GET	`/v1/run-usage/summary`	`usage:read`

Cet appel n'accepte aucun paramètre.

Lire la synthèse

curl

curl https://api.think.ultineo.com/v1/run-usage/summary \
  -H "Authorization: Bearer sk-project-YOUR_KEY"

json

{
  "code": 200,
  "title": "OK",
  "response": {
    "object": "usage",
    "plan": {
      "id": "plan_0664fc57b92acb9124be",
      "name": "Starter",
      "priority": "low",
      "model": "qwen3 8B",
      "parallel": 1
    },
    "cycle": {
      "start": 1752537600,
      "end": 1755216000
    },
    "tokens": {
      "bucket_included": 1000000,
      "used": 148320,
      "input": 141908,
      "output": 6412,
      "bucket_remaining": 851680,
      "purchased_active": 0,
      "purchased_remaining": 0,
      "available": 851680
    },
    "runs": {
      "total": 217,
      "finished": 203,
      "failed": 6,
      "pending": 8
    }
  }
}

L'objet de consommation

Champ	Type	Description
`object`	chaîne	Toujours `usage`.
`plan`	objet	L'abonnement sur lequel court le projet.
`cycle`	objet	Le cycle de facturation sur lequel les chiffres de tokens sont mesurés.
`tokens`	objet	Quota et consommation de tokens.
`runs`	objet	Les décomptes d'exécutions cumulés, par statut.

plan

Champ	Type	Description
`id`	chaîne	L'identifiant de l'abonnement, préfixé `plan_`.
`name`	chaîne	Le nom de l'abonnement.
`priority`	chaîne	La façon dont le travail du projet est mis en file : `low`, `medium` ou `high`.
`model`	chaîne	Le meilleur modèle que débloque l'abonnement.
`parallel`	entier	Le nombre d'exécutions que le projet peut mener de front.

cycle

Champ	Type	Description
`start`	entier	Le moment où le cycle en cours a commencé, en secondes Unix.
`end`	entier	Le moment où il se réinitialise, en secondes Unix.

Le cycle est un mois glissant ancré sur la date d'activation de l'abonnement : il ne coïncide donc généralement pas avec un mois calendaire. end est le moment où used revient à zéro.

tokens

Champ	Type	Description
`bucket_included`	entier	Les tokens que l'abonnement inclut par cycle.
`used`	entier	Les tokens consommés sur ce cycle, entrée plus sortie.
`input`	entier	La part d'entrée de `used`.
`output`	entier	La part de sortie de `used`.
`bucket_remaining`	entier	Ce qui reste du quota propre à l'abonnement, jamais négatif.
`purchased_active`	entier	Les tokens détenus dans des packs ponctuels actuellement valides.
`purchased_remaining`	entier	Ce qui reste de ces packs.
`available`	entier	Ce que le projet peut réellement encore dépenser.

available est le chiffre qui compte : il combine le quota de l'abonnement et tout crédit acheté, et c'est celui que teste l'appel d'exécution. Lorsqu'il atteint zéro, POST /v1/run/create est refusé par un 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-parcours. Une exécution refusée n'est jamais mise en file : rien n'est donc dépensé partiellement.

runs

Champ	Type	Description
`total`	entier	Toutes les exécutions que le projet a lancées depuis sa création.
`finished`	entier	Les exécutions qui se sont achevées.
`failed`	entier	Les exécutions qui se sont terminées en erreur.
`pending`	entier	Les exécutions encore en file ou en cours.

Ces quatre chiffres sont des totaux cumulés pour le projet, et non des chiffres du cycle en cours, et ils comptent les exécutions de toutes les origines — l'espace de travail comme l'API.

Note — pending est le décompte à surveiller face à plan.parallel. S'il reste à la limite de parallélisme, les nouvelles exécutions sont acceptées mais attendent leur tour.

Pour les autres totaux du projet — membres d'équipe, clés, fichiers et événements — voir Consommation du projet.

Envoyer des commentaires

Contacter le support

Conditions d'utilisation Confidentialité Cookies