向 ChatGPT 提问时可附上照片

通过 API 或 Playground 在 ChatGPT 提问中附上最多 4 张照片，获取 ChatGPT 看图写出的回答及其来源和搜索查询。

获得的结果

• payload.images：随 ChatGPT 任务的第一个问题一起发送的照片，最多 4 张，使用公开的图片 URL 或数据 URL。
• 回答与其他 ChatGPT 回答使用相同字段：text、markdown、sources、searchQueries，以及 ChatGPT 展示的商品和地点。
• 在 Playground 中，用输入框的照片按钮给 ChatGPT 提问附上照片，也可以把照片粘贴或拖放到输入框。附上的照片显示在对话中你的消息上方。
• 同一请求中的 followUps 会在同一对话中继续就照片提问。

工作原理

照片随新 ChatGPT 对话的第一个问题一起发送，方式与在 chatgpt.com 用照片按钮添加照片相同。ChatGPT 查看照片，在问题需要时搜索网页，并附上来源作答。在下面的示例中，ChatGPT 认出照片中是一套手冲咖啡器具，搜索了 “where to buy ceramic pour over coffee dripper white Hario V60”，并推荐了 HARIO USA 的 HARIO V60 Ceramic Coffee Dripper（$30.50）、Kalita USA 的 Kalita Style 102 Ceramic Coffee Dripper（$20.00）和 Williams Sonoma 的 HARIO V60 Coffee Pour Over Kit（$56.95）。

向 ChatGPT 提问前，每张照片读取一次：数据 URL 直接解码，URL 从公开的主机下载，每张最大 10 MB，支持 JPEG、PNG、WebP 和 GIF。照片下载或打开失败时，任务以 BAD_PAYLOAD 结束，失败的任务免费。

数据 URL 放在请求体中，请求体最大 1 MiB，因此较大的照片用 URL 发送。Playground 以数据 URL 发送照片并缩小较大的照片，一条消息可容纳 4 张照片。

带照片的问题从 payload.country 指定的国家提问，并可用 followUps 继续。与 payload.location、HK 或 CN 的 country、continueFrom 一起发送时返回 400 VALIDATION_ERROR，开启 include.html 时返回 422 EVIDENCE_UNSUPPORTED。

应用场景

• 向 ChatGPT 展示你的产品照片并询问在哪里购买，查看它推荐的商店和价格中是否有你的店铺。
• 就你或竞品的包装照片提问，查看 ChatGPT 认出的品牌以及它引用的页面。
• 就菜单、标签或你页面的截图提问，把 ChatGPT 读出的内容与你发布的内容进行比较。

开始使用

1. 打开 Playground，停留在回答引擎，并在输入框中保持 ChatGPT 为引擎。
2. 点击照片按钮（添加照片），选择最多 4 张照片；也可以把照片粘贴或拖放到输入框。
3. 输入问题并点击发送。照片显示在你的消息上方，回答附带来源返回。
4. 把回答切换到 cURL 并点击“复制 cURL”，即可在终端运行包含照片的同一请求。

发送请求

在 Authorization 请求头中带上 API 密钥发送请求。

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"]
    }
  }'

请求字段

taskTypestring必填

要运行的引擎，例如 CHATGPT 或 GOOGLE。

payload.promptstring必填

按用户在聊天框中输入的方式写的问题，最多 100,000 个字符。

payload.imagesarray

随第一个问题一起发送的照片，1 到 4 张，使用公开的 http(s) URL 或 data:image/…;base64, 数据 URL。支持 JPEG、PNG、WebP、GIF，每张最大 10 MB。followUps 会继续就这些照片提问。适用于 CHATGPT。

payload.countrystring

提问所在市场的两位国家代码，例如 US、KR、JP。默认 US。

payload.followUpsarray

在第一个回答之后，于同一 ChatGPT 对话中继续的轮次，最多 4 个。每项为发送问题的 {"prompt": "…"}，或点击上一个回答中表单按钮的 {"select": {…}}。适用于 CHATGPT。

webhook.urlstring

你服务器上的 HTTPS 地址。任务完成后立即把结果推送到这里。

响应

完成的任务如下所示，已截取部分内容。

{
  "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，最终为附带回答的 COMPLETED 或附带 error 的 FAILED。

credits.creditsChargedinteger

已完成任务扣除的积分。失败的任务为 0。

response.textstring

纯文本形式的回答。

response.sourcesarray

回答引用的页面，按引擎展示的顺序排列，含 position、url 和 label。

response.searchQueriesarray

引擎为写出回答执行的网页搜索。

获取结果

请求会立即返回 status 为 QUEUED 的任务。用 GET /v1/async/task/{id} 轮询，直到 status 变为 COMPLETED 或 FAILED；或者加上 webhook.url，在服务器上接收同样的 task、credits 和 response。任务结束后，结果保留 24 小时供查询。

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

错误

VALIDATION_ERRORHTTP 400

payload.images 发送给了 CHATGPT 以外的引擎、为空、照片超过 4 张、含有 http(s) URL 或图片数据 URL 以外的值，或者与 payload.location、HK 或 CN 的 country、continueFrom 一起发送。details 会指明该字段。

EVIDENCE_UNSUPPORTEDHTTP 422

对带有 payload.images 的问题开启了 include.html。

PAYLOAD_TOO_LARGEHTTP 413

请求体超过 1 MiB，批量请求超过 8 MiB。

MISSING_API_KEYHTTP 401

缺少 Authorization 请求头，或密钥有误、已过期或已吊销。

INSUFFICIENT_CREDITSHTTP 402

余额低于任务价格。充值积分或升级套餐后再发送。

价格

每个回答 1 个积分，带照片也与 ChatGPT 任务相同。每个追问的回答再加 1 个积分。以 BAD_PAYLOAD 结束的任务免费。