Passer au contenu principal

Avant de commencer

Il vous faut une clé d’API. Créez-en une sur la page Clés d’API du tableau de bord. Les nouveaux comptes démarrent avec 500 crédits gratuits. Les tarifs sont détaillés dans Plans et crédits de l’API.

1. Définir votre clé d’API

Gardez la clé sur votre serveur. Consultez Authentification.

2. Soumettre une tâche

Posez une question à Gemini. taskType choisit le moteur ; payload.prompt est ce que vous demandez.
L’API accepte la tâche et la met en file. Par exemple :
credits vaut zéro à la soumission. Le prix de la tâche est bloqué sur votre solde à son démarrage, prélevé quand elle se termine et libéré si elle échoue. Consultez Crédits et limites.
Les moteurs conversationnels comme GEMINI lisent payload.prompt. GOOGLE_AIO, GOOGLE_AIMODE, les moteurs Naver, GOOGLE_SERP et GOOGLE_PLACES lisent payload.query. Chacun se rabat sur l’autre champ, donc l’un ou l’autre fonctionne. Consultez Quel champ du payload est lu.

3. Récupérer le résultat

Ajoutez webhook.url à la soumission. Quand la tâche se termine, querying.ai envoie le résultat en POST à cette URL : vous n’avez jamais à interroger l’API.
Votre endpoint reçoit { task, credits, response }. Chaque livraison est signée avec une clé dérivée de votre clé d’API ; vérifiez la signature avant de faire confiance au corps. Consultez Webhooks pour la signature, les nouvelles tentatives et la charge utile.

Étapes suivantes

Choisir un moteur

Chaque taskType, ce qu’il renvoie et ce qu’il coûte.

Lots et grilles

Soumettez jusqu’à 500 tâches par requête, ou 10 000 en un seul lot.

Webhooks

Charges utiles, vérification de signature et nouvelles tentatives.

Crédits et limites

Prix, concurrence et plafonds quotidiens.