Joignez jusqu’à 4 photos à une question ChatGPT depuis l’API ou le Playground, et recevez la réponse que ChatGPT rédige à leur sujet, avec ses sources et ses recherches.
payload.images : jusqu’à 4 photos envoyées avec la première question d’une tâche ChatGPT, sous forme d’URL d’image publiques ou de data URL.text, markdown, sources, searchQueries, ainsi que les produits et les lieux affichés par ChatGPT.followUps de la même requête continuent de poser des questions sur les photos dans la même conversation.Les photos partent avec la première question d’une nouvelle conversation ChatGPT, comme lorsqu’un utilisateur les ajoute avec le bouton photo de chatgpt.com. ChatGPT regarde les photos, cherche sur le web quand la question le demande et répond avec ses sources. Dans l’exemple ci-dessous, ChatGPT a reconnu un set de café filtre sur la photo, a cherché « where to buy ceramic pour over coffee dripper white Hario V60 » et a recommandé le HARIO V60 Ceramic Coffee Dripper de HARIO USA ($30.50), le Kalita Style 102 Ceramic Coffee Dripper de Kalita USA ($20.00) et le HARIO V60 Coffee Pour Over Kit de Williams Sonoma ($56.95).
Chaque photo est lue une fois avant d’interroger ChatGPT : une data URL est décodée, une URL est téléchargée depuis son hôte public, jusqu’à 10 Mo par photo, en JPEG, PNG, WebP ou GIF. Si une photo échoue au téléchargement ou à l’ouverture, la tâche se termine avec BAD_PAYLOAD, et une tâche en échec est gratuite.
Une data URL voyage dans la requête, qui accepte jusqu’à 1 Mio : les grandes photos partent donc en URL. Le Playground envoie les photos en data URL et réduit les plus grandes, si bien que 4 photos tiennent dans un message.
Une question avec photos part du pays de payload.country et se poursuit avec followUps. Avec payload.location, un country HK ou CN, ou continueFrom, la requête renvoie 400 VALIDATION_ERROR, et avec include.html activé, elle renvoie 422 EVIDENCE_UNSUPPORTED.
Envoyez la requête avec votre clé API dans l’en-tête Authorization.
curl -X POST https://api.querying.ai/v1/async/task \
-H "Authorization: Bearer $QUERYING_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"taskType": "CHATGPT",
"payload": {
"prompt": "What is this, and where can I buy one?",
"country": "US",
"images": ["https://querying.ai/changelog/chatgpt-photos-example.jpg"]
}
}'taskTypestringObligatoireCHATGPT ou GOOGLE.payload.promptstringObligatoirepayload.imagesarraydata:image/…;base64,. JPEG, PNG, WebP ou GIF, jusqu’à 10 Mo chacune. Les followUps continuent de poser des questions à leur sujet. Pour CHATGPT.payload.countrystringUS, KR ou JP. Par défaut US.payload.followUpsarray{"prompt": "…"} pour poser une question, ou {"select": {…}} pour appuyer sur un bouton du formulaire de la réponse précédente. Pour CHATGPT.webhook.urlstringVoici une tâche terminée, raccourcie pour la lecture.
{
"success": true,
"task": {
"id": "d4f322bc-4d27-4800-a6b4-f0cb9f66f4b0",
"taskType": "CHATGPT",
"status": "COMPLETED",
"createdAt": "2026-10-28T04:56:48.117Z"
},
"credits": { "creditsToCharge": 1, "creditsCharged": 1 },
"response": {
"text": "This is a **pour-over coffee brewing setup**. The white ceramic cone is a coffee dripper, and the glass pot underneath is a carafe. …\n\n## Where to buy a similar setup\n\n…\n\n**1. HARIO V60 Ceramic Coffee Dripper**\n\n## $30.50\n\nHARIO USA\n\nA classic white ceramic cone with spiral ridges, very similar to the one pictured. …",
"sources": [
{
"position": 1,
"url": "https://www.hario-usa.com/products/v60-coffee-pour-over-02-ceramic-kit",
"label": "V60 Ceramic Pour Over Coffee Set – Hario USA",
"attribution": "hario-usa.com"
}
],
"searchQueries": [
"where to buy ceramic pour over coffee dripper white Hario V60"
],
"model": "gpt-6"
}
}task.statusstringQUEUED, PROCESSING, puis COMPLETED avec la réponse ou FAILED avec error.credits.creditsChargedintegerresponse.textstringresponse.sourcesarrayposition, url et label.response.searchQueriesarrayLa requête renvoie aussitôt la tâche avec status QUEUED. Interrogez GET /v1/async/task/{id} jusqu’à ce que status vaille COMPLETED ou FAILED, ou ajoutez webhook.url pour recevoir la tâche terminée sur votre serveur, avec les mêmes task, credits et response. Les résultats restent disponibles 24 heures après la fin de la tâche.
curl https://api.querying.ai/v1/async/task/$TASK_ID \
-H "Authorization: Bearer $QUERYING_API_KEY"VALIDATION_ERRORHTTP 400payload.images a été envoyé à un moteur autre que CHATGPT, est vide, contient plus de 4 photos ou une valeur autre qu’une URL http(s) ou une data URL d’image, ou accompagne payload.location, un country HK ou CN, ou continueFrom. details indique le champ.EVIDENCE_UNSUPPORTEDHTTP 422include.html est activé pour une question avec payload.images.PAYLOAD_TOO_LARGEHTTP 413MISSING_API_KEYHTTP 401Authorization manque, ou sa clé est inconnue, expirée ou révoquée.INSUFFICIENT_CREDITSHTTP 402Chaque réponse coûte 1 crédit, le prix d’une tâche ChatGPT, avec ou sans photos. Chaque réponse de relance ajoute 1 crédit. Une tâche terminée avec BAD_PAYLOAD est gratuite.
Interrogez l’onglet Shopping de Google aux États-Unis avec Commerce Search, puis lisez un produit avec Commerce Product pour obtenir chaque boutique listée par Google, avec son prix, son stock et sa page produit.
Envoyez l’URL d’une page à GEO Score et recevez la part de la page que ChatGPT search conserve, ce que ChatGPT reçoit quand il ouvre la page, ainsi que la cause et la correction de chaque élément manquant.
Recevez les mises à jour par e-mail.