画像検索ツールを使用すると、モデルは入力画像に基づいて、視覚的に類似した画像をインターネットで検索できます。その後、モデルは検索結果を分析し、推論を行うことができます。この機能は、類似製品の検索や視覚コンテンツの出所の追跡などのシナリオで役立ちます。
使用方法
画像検索機能は、Responses API を介して呼び出すことができます。 image_search ツールを tools パラメーターに追加し、マルチモーダル形式で input パラメーターに画像を渡します。
inputパラメーターには画像コンテンツを含める必要があります。input_imageタイプを使用して画像 URL を渡します。input_textタイプを使用してテキストを渡し、検索の追加情報を提供することもできます。
サポートされているモデル
推奨モデル
ツール呼び出しのパフォーマンスを最適化するには、次のモデルを推奨します:
Qwen-Plus: Qwen3.7-Plus シリーズ、Qwen3.6-Plus シリーズ、Qwen3.5-Plus シリーズ
Qwen-Max:qwen4-max-preview (Token Plan 限定)、Qwen3.8-Max シリーズ、qwen3.7-max-2026-06-08
qwen3.8-27b
その他のモデル
次のモデルもこのツールをサポートしていますが、パフォーマンスは推奨モデルほど高くありません。
- Qwen-Flash: Qwen3.7-Flash シリーズ、Qwen3.6-Flash シリーズ、Qwen3.5-Flash シリーズ
はじめに
次のコードを実行して、Responses API 経由で画像検索ツールを呼び出し、入力画像に基づいて類似または関連する画像を検索できます。
開始する前に、API キーを取得し、API キーを環境変数として設定してください。
サンプルコードの image_url を、一般公開されている画像の URL に置き換えてください。
ストリーミング出力
画像検索ツールは処理に時間がかかります。ストリーミング出力を有効にすると、中間結果をリアルタイムで取得できます。
課金
課金には、以下の項目が含まれます:
- モデル呼び出し料金: 画像検索の結果はプロンプトに追加されます。これにより、モデルの入力トークン数が増加します。料金は、モデルの標準レートに基づいて請求されます。料金の詳細については、「Model Studio」コンソールをご参照ください。
- ツール呼び出し料金: 1,000 コールごとに課金されます。 シンガポールリージョンでのデプロイメント料金は $8.00 ですが、華北 2 (北京) でのデプロイメント料金は $6.881 です。
よくある質問
Q: サポートされている画像形式と入力方法
A: 詳細については、「画像の制限」および「ファイルの入力方法」をご参照ください。
OpenAI SDK は、ローカルファイルパスの受け渡しをサポートしていません。
Q: 渡すことができる画像の数
A: 渡すことができる画像の数は、モデルの最大入力長によって制限されます。画像とテキストの両方の合計トークン数が、モデルがサポートする最大値を超えないようにする必要があります。モデルは 1 回の呼び出しで 1 枚の画像のみを検索しますが、複数回呼び出すことで複数の画像を処理できます。
モデルは検索する画像の数を決定します。