Le changement
Ce qui est implémenté
Tous les moteurs s’exécutent de façon asynchrone ; aucun endpoint ne bloque jusqu’à l’arrivée d’une réponse.
Là où le comportement diffère
1. Les limites s'appliquent par identifiant, par compte et par clé
1. Les limites s'appliquent par identifiant, par compte et par clé
Les clés API partagent la concurrence du compte. La soumission de tâches et le polling avec une clé API n’ont pas de limite fixe de RPM. Ces limites restent applicables :
- En cas de surcharge de l’API, la réponse est
503 SERVER_OVERLOADEDavecRetry-After. Réessayez après ce délai. - Votre plan plafonne le nombre de tâches de votre compte qui peuvent s’exécuter à la fois. Au-delà, les tâches attendent dans la file et démarrent quand des tâches en cours se terminent. Un compte peut avoir 1 000 000 tâches en attente ; au-delà, la soumission renvoie
429 QUEUE_LIMIT_EXCEEDED. - Une clé peut porter une limite quotidienne de crédits. Au-delà, la soumission renvoie
429 KEY_DAILY_CREDIT_LIMITjusqu’au prochain minuit UTC.
2. Les crédits dépendent du moteur, et le polling les indique
2. Les crédits dépendent du moteur, et le polling les indique
Chaque moteur a son propre prix : par exemple 1 crédit pour ChatGPT et Perplexity, 1,25 pour Gemini et Google AI Overviews. Le catalogue des moteurs liste tous les prix.Les réponses de soumission indiquent
{ "creditsToCharge": 0, "creditsCharged": 0 }. Une fois la tâche COMPLETED, le polling et le webhook indiquent le montant prélevé. Les tâches échouées ne sont pas facturées.3. Certaines paires moteur-région sont refusées à la soumission
3. Certaines paires moteur-région sont refusées à la soumission
Un moteur et un pays sans route renvoient immédiatement
422 REGION_UNSUPPORTED, au lieu d’accepter une tâche vouée à l’échec. Réessayer la même paire ne sert à rien.Un client qui suppose que toute soumission bien formée est acceptée doit prévoir une branche pour 422. Consultez Régions et localisation.4. Les flags include non pris en charge sont ignorés ou refusés
4. Les flags include non pris en charge sont ignorés ou refusés
Tous les moteurs n’honorent pas les flags
payload.include. Un flag markdown, rawResponse ou searchQueries non pris en charge est ignoré. Un flag html ou analysis non pris en charge renvoie 422, et un flag citationAnalysis non pris en charge renvoie 400. Vérifiez la matrice de prise en charge avant de les envoyer.5. Les webhooks sont signés
5. Les webhooks sont signés
Chaque webhook porte les en-têtes
querying-webhook-id, querying-webhook-timestamp et querying-webhook-signature. Votre récepteur actuel continue de fonctionner s’il les ignore, mais vous devriez les vérifier. Consultez Webhooks.6. Une tâche échouée ajoute une chaîne d'erreur au premier niveau
6. Une tâche échouée ajoute une chaîne d'erreur au premier niveau
GET /v1/async/task/{id} sur une tâche FAILED renvoie un champ error au premier niveau. C’est une simple chaîne, pas l’objet { code, message, timestamp } utilisé par les erreurs de requête.body.error truthy comme une requête échouée interprétera mal une tâche échouée. Branchez sur task.status.Correspondance entre moteurs et types de tâche
GOOGLE_AIO renvoie une enveloppe de page de résultats avec l’AI Overview dans un membre aioverview pouvant être null. Consultez Google AI Overviews.
Valider la bascule
Faites tourner votre intégration actuelle et querying.ai en parallèle pendant un temps et comparez les champs que vous consommez, généralementresponse.text, response.sources[] et response.markdown. Une comparaison en miroir détecte des différences qu’une vérification de schéma manque, comme une liste de sources dans un ordre différent.