Hängen Sie über die API oder den Playground bis zu 4 Fotos an eine ChatGPT-Frage und erhalten Sie die Antwort, die ChatGPT dazu schreibt, mit Quellen und Suchanfragen.
Was Sie erhalten
payload.images: bis zu 4 Fotos, die mit der ersten Frage einer ChatGPT-Aufgabe gesendet werden, als öffentliche Bild-URLs oder Data-URLs.
Die Antwort kommt mit denselben Feldern wie jede ChatGPT-Antwort: text, markdown, sources, searchQueries sowie den Produkten und Orten, die ChatGPT gezeigt hat.
Im Playground hängt die Foto-Schaltfläche im Eingabefeld Fotos an eine ChatGPT-Frage, und ein Foto, das Sie in das Feld einfügen oder hineinziehen, wird ebenfalls angehängt. Die Fotos erscheinen im Chat über Ihrer Nachricht.
followUps in derselben Anfrage fragen im selben Chat weiter zu den Fotos.
So funktioniert es
Die Fotos gehen mit der ersten Frage eines neuen ChatGPT-Chats mit, so wie ein Nutzer sie über die Foto-Schaltfläche auf chatgpt.com hinzufügt. ChatGPT sieht sich die Fotos an, sucht im Web, wenn die Frage es erfordert, und antwortet mit Quellen. Im Beispiel unten erkannte ChatGPT auf dem Foto ein Pour-over-Kaffeeset, suchte nach „where to buy ceramic pour over coffee dripper white Hario V60“ und empfahl den HARIO V60 Ceramic Coffee Dripper von HARIO USA ($30.50), den Kalita Style 102 Ceramic Coffee Dripper von Kalita USA ($20.00) und das HARIO V60 Coffee Pour Over Kit von Williams Sonoma ($56.95).
Jedes Foto wird einmal gelesen, bevor ChatGPT gefragt wird: Eine Data-URL wird dekodiert, eine URL von ihrem öffentlichen Host geladen, bis zu 10 MB pro Foto, als JPEG, PNG, WebP oder GIF. Scheitert das Laden oder Öffnen eines Fotos, endet die Aufgabe mit BAD_PAYLOAD, und eine fehlgeschlagene Aufgabe ist kostenlos.
Eine Data-URL reist im Request mit, der bis zu 1 MiB fasst, daher gehen große Fotos als URL. Der Playground sendet Fotos als Data-URLs und verkleinert große, sodass 4 Fotos in eine Nachricht passen.
Eine Frage mit Fotos wird aus dem Land in payload.country gestellt und geht mit followUps weiter. Mit payload.location, einem countryHK oder CN oder continueFrom liefert die Anfrage 400 VALIDATION_ERROR, und mit aktivem include.html liefert sie 422 EVIDENCE_UNSUPPORTED.
Einsatzbereiche
Zeigen Sie ChatGPT ein Foto Ihres Produkts, fragen Sie, wo man es kauft, und sehen Sie, welche Shops und Preise es empfiehlt und ob Ihr Shop dabei ist.
Fragen Sie zu einem Foto Ihrer Verpackung oder der eines Wettbewerbers und lesen Sie, welche Marke ChatGPT nennt und welche Seiten es zitiert.
Fragen Sie zu einer Speisekarte, einem Etikett oder einem Screenshot Ihrer Seite und vergleichen Sie, was ChatGPT darin liest, mit dem, was Sie veröffentlicht haben.
So legen Sie los
Öffnen Sie den Playground, bleiben Sie bei Antwort-Engines und lassen Sie ChatGPT als Engine im Eingabefeld.
Wählen Sie die Foto-Schaltfläche (Fotos anhängen) und bis zu 4 Fotos, oder fügen Sie die Fotos in das Eingabefeld ein oder ziehen Sie sie hinein.
Geben Sie Ihre Frage ein und wählen Sie Senden. Die Fotos erscheinen über Ihrer Nachricht, und die Antwort kommt mit ihren Quellen.
Schalten Sie die Antwort auf cURL um und wählen Sie cURL kopieren, um dieselbe Anfrage samt Fotos im Terminal auszuführen.
Anfrage senden
Senden Sie die Anfrage mit Ihrem API-Schlüssel im Header 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"]
}
}'
Felder der Anfrage
taskTypestringPflicht
Die Engine, die die Aufgabe ausführt, etwa CHATGPT oder GOOGLE.
payload.promptstringPflicht
Die Frage, so formuliert, wie ein Nutzer sie in den Chat tippt. Bis zu 100.000 Zeichen.
payload.imagesarray
1 bis 4 Fotos zur ersten Frage, als öffentliche http(s)-URLs oder Data-URLs data:image/…;base64,. JPEG, PNG, WebP oder GIF, bis zu 10 MB pro Foto. followUps fragen weiter zu ihnen. Für CHATGPT.
payload.countrystring
Zweistelliger Ländercode des Markts, aus dem gefragt wird, etwa US, KR oder JP. Standard US.
payload.followUpsarray
Bis zu 4 weitere Runden im selben ChatGPT-Chat nach der ersten Antwort. Jeder Eintrag ist {"prompt": "…"} für eine Frage oder {"select": {…}}, um eine Schaltfläche im Formular der vorigen Antwort zu drücken. Für CHATGPT.
webhook.urlstring
Eine HTTPS-Adresse Ihres Servers. Die fertige Aufgabe wird dorthin gesendet, sobald sie abgeschlossen ist.
Antwort
So sieht eine fertige Aufgabe aus, für die Lesbarkeit gekürzt.
JSON
{
"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.statusstring
QUEUED, PROCESSING, dann COMPLETED mit der Antwort oder FAILED mit error.
credits.creditsChargedinteger
Für die fertige Aufgabe berechnete Credits. Eine fehlgeschlagene Aufgabe kostet 0.
response.textstring
Die Antwort als reiner Text.
response.sourcesarray
Die Seiten, die die Antwort zitiert, in der Reihenfolge der Engine, mit position, url und label.
response.searchQueriesarray
Die Websuchen, die die Engine für die Antwort ausgeführt hat.
Ergebnis abholen
Die Anfrage liefert sofort die Aufgabe mit statusQUEUED. Fragen Sie GET /v1/async/task/{id} ab, bis statusCOMPLETED oder FAILED ist, oder geben Sie webhook.url an, dann kommt die fertige Aufgabe mit denselben task, credits und response auf Ihrem Server an. Ergebnisse bleiben 24 Stunden nach Abschluss abrufbar.
payload.images wurde an eine andere Engine als CHATGPT gesendet, ist leer, enthält mehr als 4 Fotos oder einen Wert, der weder eine http(s)-URL noch eine Bild-Data-URL ist, oder kommt zusammen mit payload.location, einem countryHK oder CN oder continueFrom. details nennt das Feld.
EVIDENCE_UNSUPPORTEDHTTP 422
include.html ist für eine Frage mit payload.images aktiv.
PAYLOAD_TOO_LARGEHTTP 413
Der Body ist größer als 1 MiB, bei einem Batch größer als 8 MiB.
MISSING_API_KEYHTTP 401
Der Header Authorization fehlt, oder sein Schlüssel ist unbekannt, abgelaufen oder widerrufen.
INSUFFICIENT_CREDITSHTTP 402
Das Guthaben liegt unter dem Preis der Aufgabe. Laden Sie Credits auf oder wechseln Sie den Plan und senden Sie erneut.
Preis
Jede Antwort kostet 1 Credit, den Preis einer ChatGPT-Aufgabe, mit oder ohne Fotos. Jede Antwort auf eine Folgefrage kostet 1 Credit mehr. Eine Aufgabe, die mit BAD_PAYLOAD endet, ist kostenlos.
Durchsuchen Sie mit Commerce Search den Shopping-Tab von Google in den USA und lesen Sie ein Produkt mit Commerce Product, um jeden Shop zu erhalten, den Google dafür listet, mit Preis, Lagerstatus und Produktseite.
Senden Sie eine Seiten-URL an GEO Score und erhalten Sie den Anteil der Seite, den ChatGPT Search hat, was ChatGPT beim Öffnen der Seite erhält, und für jeden fehlenden Teil den Grund und die Lösung.