API Gemini : réponses, sources d'ancrage et fiches produit - querying.ai

GEMINI interroge Google Gemini et renvoie la réponse avec les sources sur lesquelles elle s’appuie.


taskType	`GEMINI`
Lit	`prompt` (se rabat sur `query`)
Crédits	1,25
Pays	Facultatif, `US` par défaut. `CN` est interrogé depuis une sortie aux États-Unis avec une localisation d’appareil à Pékin.
Localisation	Accepte `payload.location`. Consultez Régions et localisation.

Requête

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "GEMINI", "payload": { "prompt": "best CRM for a small team", "country": "US" } }'

Réponse

Champ	Type	Description
`text`	string	La réponse. Toujours présent.
`sources`	array	Sources d’ancrage : `position`, `url`, `label`, `description` et `confidence_level` (0-100). Toujours présent.
`model`	string	Le modèle avec lequel Gemini a répondu, quand il est connu.
`markdown`	string	La réponse en Markdown. Uniquement avec `include.markdown`.
`shoppingCards`	array	Fiches produit affichées dans la réponse : `title`, `position`, `price` (`value`, `currency`, `raw`), `store`, `rating`, `reviews`, `thumbnail`, `productLink`.
`inlineProducts`	array	Noms de produit liés dans la réponse : `title`, `position`, `productLink`.
`map`	array	Lieux de la réponse : `name`, `position`, `placeId`, `location`, `phoneNumber`, `url`, `mapsUrl`, `reviews`, `category`.
`videos`	array	Cartes YouTube : `title`, `url`, `medium`, `thumbnail`, `source`, `duration`.
`images`	array	Images affichées avec la réponse.
`weather`	object	Le widget météo de Gemini, quand la réponse en affiche un.
`rawResponse`	array	Trames du flux. Uniquement avec `include.rawResponse`.

Les champs de produits, de lieux, de vidéos et de météo n’apparaissent que lorsque la réponse les affiche. Par exemple :

{
  "text": "For a small team, HubSpot CRM and Pipedrive are strong choices ...",
  "sources": [
    { "position": 1, "url": "https://www.example.com/crm-guide", "label": "CRM guide for small teams", "confidence_level": 87 }
  ],
  "model": "...",
  "shoppingCards": [
    {
      "title": "Acme Desk Phone",
      "position": 1,
      "price": { "value": 249.99, "currency": "$", "raw": "$249.99" },
      "store": "Northwind Electronics",
      "rating": 4.7,
      "reviews": "14292",
      "thumbnail": "https://...",
      "productLink": "https://google.com/search?...&ibp=oshop..."
    }
  ]
}

Les noms des cartes restent dans text, et les liens produit du texte pointent vers la page produit de Google. Une carte YouTube apparaît dans text et markdown sous forme de miniature liée, là où Gemini l’affiche. Quand Gemini exécute du code pour faire un calcul, la réponse est le résultat qu’il énonce ; le code et sa sortie sont exclus.

Flags include

Flag	Effet
`markdown`	Ajoute `markdown`.
`rawResponse`	Ajoute `rawResponse`.
`html`	Ajoute `html`, l’écran affiché par Gemini. Consultez Pages HTML.
`analysis`	Ajoute `analysis`, 1 crédit. Consultez Analyse de la réponse.
`citationAnalysis`	Lance une Citation Analysis sur la réponse.

searchQueries, ads et shopping n’ont aucun effet. Consultez Réponses Markdown et brutes.

Voir aussi