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 は公開されているホストからダウンロードします。1枚10MBまで、形式は JPEG、PNG、WebP、GIF です。写真のダウンロードや読み込みに失敗すると、タスクは BAD_PAYLOAD で終わり、失敗したタスクは無料です。

データ URL はリクエスト本文に入り、本文は 1 MiB まで受け付けるため、大きな写真は URL で送ります。Playgroundは写真をデータ URL で送り、大きな写真は縮小するので、1つのメッセージに写真4枚が収まります。

写真を添えた質問は payload.country の国から聞き、followUps で続けられます。payload.location、HK か CN の country、continueFrom と一緒に送ると 400 VALIDATION_ERROR、include.html をオンにすると 422 EVIDENCE_UNSUPPORTED になります。

活用例

• 自社製品の写真を見せてどこで買えるかを聞き、ChatGPTが勧める販売店と価格に自社の店舗が入っているかを確認します。
• 自社や競合のパッケージ写真について聞き、ChatGPTがどのブランドだと答えるか、根拠にしたページはどこかを読みます。
• メニュー、ラベル、自社ページのスクリーンショットについて聞き、ChatGPTが読み取った内容を公開している内容と比べます。

使い方

1. プレイグラウンドを開き、回答エンジンのまま、入力欄のエンジンをChatGPTにします。
2. 写真ボタン（写真を添付）を選んで写真を最大4枚選びます。入力欄に貼り付けたり、ドラッグして置いたりしても添えられます。
3. 質問を入力して送信を選びます。写真が自分のメッセージの上に表示され、回答が出典とともに届きます。
4. 回答を cURL に切り替えて「cURLをコピー」を選ぶと、写真も含めた同じリクエストをターミナルから実行できます。

リクエストを送る

API キーを 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"]
    }
  }'

リクエストのフィールド

taskTypestring必須

実行するエンジン。CHATGPT や GOOGLE などを指定します。

payload.promptstring必須

ユーザーがチャットに入力するとおりに書いた質問。最大100,000文字。

payload.imagesarray

最初の質問と一緒に送る写真、1〜4枚。公開されている http(s) URL か data:image/…;base64, のデータ URL で指定します。JPEG、PNG、WebP、GIF、1枚10MBまで。followUps は同じ写真について続けて聞きます。CHATGPT で使えます。

payload.countrystring

質問する市場の2文字の国コード。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 のタスクがすぐに返ります。status が COMPLETED か FAILED になるまで GET /v1/async/task/{id} で取得するか、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件につき1クレジットで、写真があってもChatGPTのタスクと同じです。続けて聞いた回答は1件ごとに1クレジットが加わります。BAD_PAYLOAD で終わったタスクは無料です。