`GET /v1/usage`

Consultez la ressource sélectionnée de votre compte ou l’état du flux sans lancer de génération.

Exemple de requête#

curl 'https://platform.tongai.io/v1/usage' \  -H "Authorization: Bearer $TONG_API_KEY"

Configuration

curl --version

Utilisez une clé API côté serveur pour votre compte, ou OAuth pour chaque client. N’envoyez jamais de clés dans les prompts ou arguments.

usage:read

fromstringFacultatif

Date et heure ISO 8601, par exemple 2026-10-22T09:00:00Z.

tostringFacultatif

Date et heure ISO 8601, par exemple 2026-10-22T09:00:00Z.

channelstringFacultatif

Valeurs autorisées"api""mcp"

credential_idstringFacultatif

Un identifiant hexadécimal de 24 caractères.

toolstringFacultatif

Longueur minimale : 1 caractères.

Longueur maximale : 100 caractères.

modelstringFacultatif

Choisissez un ID de modèle public Tong dans la découverte actuelle.

Longueur minimale : 1 caractères.

Longueur maximale : 150 caractères.

categorystringFacultatif

Longueur minimale : 1 caractères.

Longueur maximale : 60 caractères.

statestringFacultatif

Valeurs autorisées"accepted""running""needs_review""paused""reconciling""succeeded""failed""cancelled"

searchstringFacultatif

Longueur maximale : 150 caractères.

activitystringFacultatif

Valeurs autorisées"creative""all"

outcomestringFacultatif

Valeurs autorisées"success""error""pending""cancelled"

limitintegerFacultatif

Minimum : 1.

Maximum : 100.

Valeur par défaut : 40.

Ce point de terminaison n’a pas de corps de requête.

Réponse

JSON

{}

application/json

object

HTTP	Erreur	Reprise
`400`	Requête invalide`REQUEST_INVALID`	Corrigez les champs indiqués par l’erreur avant de réessayer.
`401`	Identifiant invalide`CREDENTIAL_INVALID`	Vérifiez l’identifiant, son expiration et son éventuelle révocation.
`402`	Crédits insuffisants`INSUFFICIENT_CREDITS`	Ajoutez des crédits au compte de l’identifiant, puis poursuivez le travail enregistré.
`403`	Autorisation refusée`SCOPE_REQUIRED`	Utilisez un identifiant disposant des autorisations requises et de l’accès à la ressource choisie.
`404`	Ressource indisponible`RESOURCE_UNAVAILABLE`	Vérifiez l’ID de la ressource et son appartenance au compte autorisé.
`409`	Conflit d’intention`IDEMPOTENCY_CONFLICT`	Réutilisez une intention uniquement avec sa requête initiale. Utilisez un nouvel UUID pour une autre action.
`429`	Limite de débit atteinte`RATE_LIMITED`	Attendez le délai Retry-After avant de répéter la même requête.
`503`	Temporairement indisponible`DEPENDENCY_UNAVAILABLE`	Attendez Retry-After et réessayez avec la même intention. Vérifiez l’opération enregistrée après un délai dépassé.