Compte
Deux points d'accès en lecture seule pour le compte propriétaire de la clé API : un instantané du plan et des crédits disponibles (avec les deux nombres dont un SDK a besoin pour se limiter), ainsi qu'un registre paginé de la consommation de crédits pour un rapprochement en libre-service.
Obtenir le compte
Renvoie le plan et les crédits effectifs de votre compte — si votre compte est membre d'une équipe, cela reflète déjà le plan/le pool de crédits du propriétaire de l'équipe, et non votre propre plan d'adhésion individuel.
Paramètres
Aucun — le compte est entièrement déterminé par la clé API dans l'en-tête Authorization.
max_batch_size et upload_concurrency sont fournis pour qu'un SDK client puisse auto-limiter sa propre boucle de téléchargement au lieu de découvrir ces limites en rencontrant d'abord des erreurs invalid_parameter/rate_limit_exceeded.
Erreurs possibles
missing_api_key/invalid_api_key/plan_required— voir Gestion des erreurs.
Obtenir l'utilisation du compte
Un registre paginé, du plus récent au plus ancien, de chaque événement affectant les crédits sur votre compte — déductions d'extraction, déductions d'annotation de boîte englobante et remboursements. Conçu pour réconcilier « combien de crédits cela m'a-t-il coûté, » pas pour piloter une interface (comparez les chaînes d'affichage pré-formatées de /profile/usage_history, que cet endpoint ne renvoie pas — vous obtenez des valeurs amount structurées et signées à la place).
Paramètres
| Nom | Emplacement | Type | Description |
|---|---|---|---|
limit | query, facultatif | entier | 1–200. Défaut 50. |
batch_name | query, facultatif | chaîne | Restreindre le registre aux entrées d'un lot — « combien de crédits le lot X m'a-t-il coûté. » |
page_token | query, facultatif | chaîne | Curseur opaque provenant du next_page_token d'une réponse précédente. Cet endpoint pagine du plus récent au plus ancien (contrairement aux autres endpoints de liste v1, qui paginent du plus ancien au plus récent) — le jeton reste opaque et fait l'aller-retour de la même manière, seul l'ordre sous-jacent diffère. Voir Pagination. |
amount est signé : négatif pour les dépenses (déductions d'extraction/boîte englobante), positif pour les crédits restitués (remboursements/remboursements d'annulation) — donc additionner les valeurs amount d'une page vous donne la variation nette sur cette page. document_id appartient au même espace d'ID que le document_id de Documents (le registre interne l'appelle task_id ; cet endpoint le renomme pour la cohérence avec le reste de la v1).
L'ampleur d'une déduction n'est pas toujours 1. Chaque compte a un niveau de modèle — Standard (le défaut), Avancé ou Premium — qui détermine quel modèle d'IA exécute ses extractions et combien de crédits chaque document traité coûte : 1 pour Standard, 3 pour Avancé, 6 pour Premium. Il n'y a aucun moyen de le définir par appel API ; il est attribué au compte par l'équipe ImageToTable.ai. Lorsqu'un compte n'est pas en Standard, le champ action porte un suffixe de niveau au lieu du nom nu — deduction_advanced, deduction_premium — afin que vous puissiez repérer une charge non-Standard sans inspecter amount directement. Les remboursements ne sont pas affectés par les changements de niveau ultérieurs : une tâche est toujours remboursée au niveau auquel elle a été réellement facturée au début du traitement, pas au niveau où se trouve le compte au moment où le remboursement est émis, donc une ligne refund aura toujours une ampleur correspondant à la ligne deduction/deduction_<tier> qu'elle annule. Voir Paramètres du compte & comportement de l'API pour savoir comment cela interagit avec chaque autre paramètre au niveau du compte que la v1 lit.
Erreurs possibles
missing_api_key/invalid_api_key/plan_required— voir Gestion des erreurs.invalid_parameter—limitoupage_tokeninvalide.