Paramètres du compte et comportement de l'API
Une partie du comportement de votre compte est configurée une seule fois — la plupart sur la page des paramètres de profil de l'application web, une exception (niveau de modèle, ci-dessous) uniquement par l'équipe ImageToTable.ai — plutôt que via cette API. Cette page explique, pour chaque paramètre, exactement comment il se manifeste dans v1 : si l'API le suit inconditionnellement, ou si elle vous permet de le remplacer par requête. Ce choix est délibéré : ces informations ne sont pas dispersées dans les documentations de chaque endpoint, mais regroupées ici, car le comportement transversal est facile à manquer si vous ne lisez qu'une page de référence d'un endpoint à la fois.
La règle générale
v1 lit directement la configuration actuelle de votre compte et l'applique — il n'existe pas de système de configuration séparé au niveau de l'API, et (à une exception délibérée près, ci-dessous) aucun moyen de remplacer un paramètre du compte pour une seule requête. C'est intentionnel : maintenir deux endroits indépendants pour configurer le même comportement (l'application web et une configuration API parallèle) finirait inévitablement par créer des divergences, et l'objectif est que le même compte se comporte de la même manière, quelle que soit la surface — application web, cette API ou le module complémentaire Google Sheets — qui a lancé le traitement.
Paramètres et leur comportement dans l'API
| Paramètre | Comportement dans l'appli web | Comportement dans l'API v1 | Peut être remplacé par requête ? |
|---|---|---|---|
annotation automatique bboxauto_annotate_bbox | Un paramètre au niveau du compte. Lorsqu'il est activé, chaque extraction terminée déclenche automatiquement une passe d'annotation bbox payante. | Suivi exactement — les lots créés et traités via v1 respectent ce paramètre sans exception. S'il est activé, vous pouvez être facturé pour l'annotation bbox même si vous n'appelez jamais POST /documents/{document_id}/bbox vous-même. | Non. Aucun moyen au niveau de la requête de l'ignorer ou de le forcer. |
qualité de traitementthinking_type | Un paramètre au niveau du compte choisissant un niveau de vitesse/qualité pour le traitement. | La seule exception à la règle ci-dessus. Lorsque vous omettez quality sur POST /batches/{batch_name}/process, il revient au paramètre actuel de votre compte — même comportement que l'application web. Mais vous pouvez aussi passer quality: "fast" ou quality: "high" sur cette requête pour le remplacer uniquement pour cet appel. | Oui — le seul paramètre de cette page que vous pouvez remplacer par requête. |
conservation des donnéesauto_delete / auto_delete_after | Un paramètre au niveau du compte pour supprimer automatiquement les images originales N jours après le traitement. | Suivi exactement — les documents créés via v1 sont soumis à la même politique de conservation que tout ce qui est importé via l'application web. | Non. |
| mode de traitement (interne rec_mode, exposé comme mode) | L'application web prend actuellement en charge l'extraction sous forme de tableau et la conversion complète du document en Word. | v1 prend actuellement en charge uniquement mode=table (extraction de champs structurés). La conversion complète du document est prévue mais pas encore disponible via l'API. | Non applicable pour le moment — il n'y a qu'une seule valeur à choisir. Lorsque d'autres modes seront disponibles, ce sera un pur ajout, pas un changement de comportement de la valeur existante. |
Niveau de modèlemodel_tier | Le modèle d'IA sur lequel s'exécutent les extractions d'un compte, et le coût de chaque document traité : Standard (1 crédit, la valeur par défaut pour chaque compte), Avancé (3 crédits) ou Premium (6 crédits). Attribué par l'équipe ImageToTable.ai — il n'existe pas de sélecteur de niveau dans les paramètres du compte. | Suivi exactement. POST /batches/{batch_name}/process déduit les crédits au tarif du niveau actuel du compte, sans possibilité de demander un autre niveau pour un appel unique. Le niveau est verrouillé au moment où cet endpoint est appelé — un document déjà en file d'attente conserve le niveau (et le coût en crédits) auquel il a été facturé, même si le niveau du compte change avant la fin du traitement de ce document, et il est remboursé à ce même niveau verrouillé s'il est ensuite annulé ou échoue. Voir Utilisation du compte pour savoir comment une charge non Standard apparaît dans le registre des crédits. | Non. Plus strict que toutes les autres lignes de cette page : ce n'est même pas un paramètre de compte en libre-service sur l'application web, il n'y a donc rien à lire et à refléter par requête — la v1 ne comporte aucun paramètre de niveau où que ce soit. |
Pourquoi ne pas simplement ajouter des remplacements au niveau de la requête ?
L'annotation automatique bbox et la politique de conservation sont traitées comme une gouvernance au niveau du compte, et non comme des préférences par appel — ce sont le genre d'interrupteur « tout activé ou tout désactivé » où laisser un appel API dévier silencieusement de la configuration permanente du compte créerait exactement le problème de dérive entre deux sources de configuration que cette conception évite. quality est différent : le niveau de vitesse/précision qui convient peut réellement varier d'un appel à l'autre (ce lot doit partir vite, celui-là nécessite une précision maximale), il est donc traité comme un choix opérationnel plutôt que comme un paramètre de gouvernance, et ouvert comme le seul remplacement possible.
Le niveau de modèle va plus loin que « aucun remplacement par requête » — ce n'est même pas un paramètre de compte en libre-service. Les autres lignes de cette page sont des éléments que vous configurez vous-même sur la page des paramètres du profil et que v1 reflète simplement ; le niveau de modèle est un tarif que l'équipe ImageToTable.ai attribue en fonction de la charge de travail qu'un compte exécute réellement, car il modifie directement le coût de chaque document. L'exposer comme un élément qu'un appelant pourrait modifier par requête (ou même par compte, sans assistance) permettrait à une seule valeur erronée de multiplier silencieusement la facture d'un lot par 3 ou 6 sans étape de confirmation intermédiaire — la version « les Credits sont de l'argent réel » du même problème de dérive que le reste de cette page évite.