https://api.tokios.comを通じてどのマシンやチームメイト、ホストされたエージェントからでも呼び出せる。インバウンドポートやVPNは一切不要だ。
Ollamaを使ってローカルで実行する
Qwen3-VLはOllamaライブラリ内でqwen3-vl という識別子で登録されている。デフォルトタグ(密集型のInstructモデルである 8B)を取得して実行する:
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といったサイズも紹介されていますが、本表ではローカル環境で利用しやすいことが確認済みのサイズに絞っています。
量子化とフォーマット
Ollamaのタグ体系ではデフォルトの量子化レベルに加えて-q8も用意されており、各サイズごとに別個の-bf16タグが存在します。それぞれのタグは-instruct版および-thinking版の両方で利用可能です。実際に利用できるフォーマットはハードウェアによって異なります。詳細な対応表については量子化フォーマットと必要なハードウェアを、量子化レベルの名称の読み方については量子化とは何かおよびQ4_K_Mの例をご参照ください。
ハードウェアへの適合性
適度なコンテキスト長であればQ4程度で問題なく動作します。表中の数値はすべて概算値であり、実際にはモデルのGGUFサイズに加えてコンテキスト分のKVキャッシュ分も必要となります。GPUに適したモデルサイズの算出方法についてはどのサイズのモデルがGPUに適合するかをご覧ください。
実行方法 — 初心者から上級者まで
- Ollama(最も簡単な方法)
- LM Studio(GUI版)
- vLLM(上級者向け)
- SGLang(高度な利用向け)
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 (次に approve を押して、Setup または Connectors タブにあるデバイスを選択します。
TKS-XXXX-XXXX). Install and run the connector on the machine running Ollama:Windows
macOS
Linux
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.どこからでも呼び出せます
注意点
- Qwen3-VL では指示モードと思考モードがそれぞれ個別のダウンロードファイルとして提供されており、切り替え機能付きの単一モデルではありません。必要なタグ(
qwen3-vl:8bまたはqwen3-vl:8b-thinking)を事前に選択しておく必要があります。 - Qwen’s official README and model cards don’t publish explicit
--tool-call-parseror--reasoning-parserflags 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-A3BMoE 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
32Band235B-A22Bvariants 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と他のローカル視覚モデルとの比較結果をご覧ください。