Skip to main content
Qwen3-VLはQwen専用のビジョン言語モデル群であり、テキストや画像、そして動画も読み取れる。ローカル環境でも扱いやすいサイズで長文コンテキストにも対応しており、通常の密集型モデル版とミックスド・オブ・エキスパーツ(MoE)版の両方が用意されている。それぞれに指示用のInstruct版と推論能力を強化したThinking版も存在する。旧版であるQwen2.5-VLに取って代わる存在だ。現在ビジョンモデルを選ぶ際はまずここから始めるべきだ。Ollama用のタグが確定済みであるからだ。一方で新しいQwen3.8-27Bも画像や動画入力に対応しているが、現時点ではllama.cpp、LM Studio、またはサーバーランタイム経由でのみ利用可能だ。ご自身のハードウェアに合ったサイズをローカルで実行した後、Tokiosコネクターを組み合わせれば、https://api.tokios.comを通じてどのマシンやチームメイト、ホストされたエージェントからでも呼び出せる。インバウンドポートやVPNは一切不要だ。

Ollamaを使ってローカルで実行する

Qwen3-VLはOllamaライブラリ内で qwen3-vl という識別子で登録されている。デフォルトタグ(密集型のInstructモデルである 8B)を取得して実行する:
他のサイズを利用する場合はタグを追加すればよい。例えばMoEモデルなら ollama run qwen3-vl:30b-a3b、推論強化版なら ollama run qwen3-vl:8b-thinking となる。全タグ一覧は Ollamaライブラリページ を参照されたい。このページでは接続方法のみ説明しており、すべてのランタイム詳細は記載していない。
Ollamaのデフォルトコンテキストウィンドウは小さく(2048トークン程度)であり、Qwen3-VL本来の能力である 256K には遠く及ばない。より多くのコンテキストを活用したい場合は、Modelfileまたはクライアントリクエスト内で num_ctx の値を引き上げる必要がある。

バリエーションとタグ

以下の値はすべてHugging FaceのモデルカードおよびOllamaライブラリから得た情報だ。新たな量子化版がリリースされるたびにタグやダウンロードサイズは変動するため、標準化する前に ollama.com/library/qwen3-vl/tags で確認してほしい。 情報源:ollama.com/library/qwen3-vl/tags、Qwen/Qwen3-VL-8B-Instructの設定、およびQwen/Qwen3-VL-30B-A3B-Instructの設定です。Ollamaのライブラリではさらに2B、4B、32B、235B-A22Bといったサイズも紹介されていますが、本表ではローカル環境で利用しやすいことが確認済みのサイズに絞っています。
The 30B-A3B model is mixture-of-experts — only 3B parameters are active per token, so it decodes faster than a dense model of the same total size. But all parameters still have to fit in memory. Don’t size your GPU off the active-parameter count alone. See how inference works for why.

量子化とフォーマット

Ollamaのタグ体系ではデフォルトの量子化レベルに加えて-q8も用意されており、各サイズごとに別個の-bf16タグが存在します。それぞれのタグは-instruct版および-thinking版の両方で利用可能です。実際に利用できるフォーマットはハードウェアによって異なります。詳細な対応表については量子化フォーマットと必要なハードウェアを、量子化レベルの名称の読み方については量子化とは何かおよびQ4_K_Mの例をご参照ください。

ハードウェアへの適合性

適度なコンテキスト長であればQ4程度で問題なく動作します。表中の数値はすべて概算値であり、実際にはモデルのGGUFサイズに加えてコンテキスト分のKVキャッシュ分も必要となります。GPUに適したモデルサイズの算出方法についてはどのサイズのモデルがGPUに適合するかをご覧ください。

実行方法 — 初心者から上級者まで

Ollamaをデフォルトの http://127.0.0.1:11434 ポートで待機させておきましょう。より多くのコンテキストを利用したい場合は num_ctx の値を上げてください。また、他のOllamaビジョンモデルと同様に、チャットリクエストに画像も添付できます。

主な機能

  • ビジョン機能: マルチモーダル対応 — 同一リクエスト内でテキスト・画像・動画を受け付け、長文文書のOCR処理やGUI・エージェントによる画面理解、空間位置の特定も可能です。
  • 長文脈対応: 262,144トークンをネイティブに処理可能であり、8Bおよび30B-A3Bの設定においてもその点が確認されている。Qwenのモデル説明書によれば、vLLM上でYaRNスケーリングを用いることでさらに拡張も可能だ。
  • 推論機能: サイズごとに二つのエディションが用意されており、Instruct(直接的な回答を生成)と Thinking(推論能力を強化した版、例えば Ollama上の qwen3-vl:8b-thinking など)があります。Qwenが公開しているvLLM/SGLang向けのデプロイ例では、Qwen3-VL用の専用推論パーサーフラグは記載されていません。
  • ツール呼び出し: Hugging Face側のチャットテンプレートでは <tool_call> というJSON形式が定義されており、Ollamaがこれを自動的に適用します。Qwen3-VL用の公式 vLLM/SGLang デプロイ例では --tool-call-parser フラグが記載されていませんので、実際に製品をリリースする前にご自身の実行環境で関数呼び出し機能を試してみてください。

Tokiosコネクターとの連携

Qwen3-VLがローカル環境で稼働したら、Tokiosコネクターをペアリングしておきましょう。そうすればClaude CodeやCline、その他互換性のあるクライアントからも https://api.tokios.com 経由でこのモデルにアクセスできるようになります。これにより、単に localhost:11434 からのみ接続できる状態から解放されます。
1

Tokiosコネクターのペアリング手順

Sign in at tokios.com/console, open the Setup tab, and click Start pairing to get a one-time claim code (TKS-XXXX-XXXX). Install and run the connector on the machine running Ollama:
Windows
macOS
Linux
次に approve を押して、Setup または Connectors タブにあるデバイスを選択します。
2

コネクターを Ollama の /v1 API に向けて設定します

Ollama は /v1 にて OpenAI 互換のインターフェースを提供しています。単一モデル環境ではコンソールのセットアップウィザードが自動的に http://127.0.0.1:11434/v1 を設定します。複数モデルを利用する場合は tokios-connector.json で明示的に設定する必要があります。詳細は コネクター設定 をご覧ください。
3

デプロイを登録します

In the Models tab, register the model and choose a public deployment name, for example qwen3-vl-tunnel. This name — not Ollama’s local model id — is what clients send in the model field.
4

APIキーを作成します

In the Keys tab, click Create key. Copy the sk-tok-… key now — it’s shown only once.

どこからでも呼び出せます

The model field is always your registered deployment name (qwen3-vl-tunnel above), never Ollama’s local model id. See Use Claude Code and Use Cline for full client setup.

注意点

  • Qwen3-VL では指示モードと思考モードがそれぞれ個別のダウンロードファイルとして提供されており、切り替え機能付きの単一モデルではありません。必要なタグ(qwen3-vl:8b または qwen3-vl:8b-thinking)を事前に選択しておく必要があります。
  • Qwen’s official README and model cards don’t publish explicit --tool-call-parser or --reasoning-parser flags for Qwen3-VL on vLLM/SGLang, unlike some other Qwen3 releases. Test tool-calling and thinking-tag behavior on your runtime before relying on it in production.
  • The 30B-A3B MoE model needs all of its total parameters in memory even though only 3B are active per token — size your hardware off the full download, not the active count.
  • The 32B and 235B-A22B variants need more hardware than most local Tokios users will have. Treat them as advanced pulls and confirm their exact files, context settings, and runtime support before planning around them.

クイックスタート

コネクターをペアリングし、最初のモデルを一通り登録してみましょう。

ご使用のGPUに適したモデルサイズはどれでしょうか?

Qwen3-VLをダウンロードする前に、利用可能なVRAM容量に合ったサイズを選ぶ必要があります。

量子化処理とハードウェア要件

Qwen3-VLが提供するフォーマットの中で、GGUFやbf16といった形式のうちどれがご使用のハードウェアで動作するでしょうか。

各タスクに適したローカルモデルはどれでしょうか?

タスク別に見た際のQwen3-VLと他のローカル視覚モデルとの比較結果をご覧ください。