Passer au contenu principal
querying.ai implémente le contrat courant de tâches asynchrones des API de moteurs de réponse. Pour les endpoints ci-dessous, les schémas de requête et de réponse sont identiques : un client fonctionnel n’a généralement besoin que d’une nouvelle URL de base et d’une nouvelle clé.

Le changement

Faites pointer votre constante de clé d’API vers une clé querying.ai issue de Clés d’API. Les URL de webhook, les clés d’idempotence, les types de tâche et l’analyse des réponses restent inchangés.

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

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_OVERLOADED avec Retry-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_LIMIT jusqu’au prochain minuit UTC.
Pour du volume, envoyez des lots plutôt que de nombreuses requêtes unitaires. Consultez Crédits et limites et Lots et grilles.
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.
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.
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.
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.
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.
Un client qui traite un 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éralement response.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.