Z-Imageで画像が出ない・OOMを解決！症状別トラブル対処チェックリスト

監修者_SD以外

監修者プロフィール

森下浩志

日本最大級のAI情報プラットフォーム「romptn ai」編集長。著書に「0からはじめるStable Diffusion」「0からはじめるStable Diffusion モデル・拡張機能集編」など、AmazonベストセラーのAI関連書籍を多数執筆。AIにおける情報の非対称性を解消するための社内研修や出張講義も行う。

Z-Imageでトラブルが起きやすい理由

まずは、なぜZ-Imageでつまずきやすいのかという前提から押さえましょう。

Z-Imageは、Alibabaの研究チームが公開した画像生成モデルです。テキストの理解にはQwen3-4Bという専用エンコーダを使い、画像の復元には専用のVAE（ae.safetensors）を使います。

さらに、わずか8ステップ前後で生成する高速設計が前提です。ここが従来のStable Diffusion（SDXL）と大きく違う点です。

そのため、SDXLの感覚でCLIPエンコーダや汎用VAEを流用したり、20〜30ステップで回したりすると、エラーは出ないのに結果だけがおかしくなる、という無言の失敗が起きます。

この記事で扱う症状の多くは、この「前提のズレ」が原因です。まずは正しい部品と設定を知り、そのうえで症状から原因を引けるようにしていきます。

必要なモデルファイルと配置先

次に、トラブルの土台になりやすい「3つの部品」と置き場所を確認します。

Z-Imageを動かすには、次の3つのファイルをそれぞれ決まったフォルダに置く必要があります。配置やファイル名を1つでも間違えると、無反応・ノイズ・プロンプト無視といった症状に直結します。

ファイルは、Comfy-Orgが配布する公式リポジトリから入手できます。

ポイントは、置いたあとに必ずComfyUI本体を再起動することです。ComfyUIは起動時にしかフォルダを読み直さないため、置いただけでは認識されません。

症状別トラブル対処チェックリスト

ここからが本題の、症状から原因を引く逆引きチェックリストです。

今あなたに出ている症状に近い見出しへ進んでください。それぞれで「原因 → まず確認する1点 → 直し方」の順にまとめています。

複数の症状が同時に出ているときは、より根本的な部分から潰すのがコツです。土台のファイル配置が崩れていると、別の症状も連鎖して起きるためです。

次の章から、代表的な5つの症状を順に見ていきます。

①OOM・メモリ不足で止まる

「out of memory」や「CUDA out of memory」で止まるのは、モデルの精度（データの重さ）とVRAMの容量が釣り合っていないのが主な原因です。

まず確認したいのは、標準のbf16版をそのまま使っていないかという点です。bf16版はもっとも重く、16GB級のVRAMを前提にしています。

手元のVRAMが足りない場合は、より軽いfp8版や、さらに軽いGGUF量子化版に差し替えるのが基本の対処です。フォーマット別の目安は、後ほどの「VRAM別モデル精度の選び方」にまとめています。

それでも厳しいときは、一部の処理をCPUに逃がすオフロード設定や、低VRAM向けの起動オプションを使います。長時間使っていて急に出るようになった場合は、メモリの断片化が原因のこともあるため、一度ComfyUIを再起動してみてください。

②画像が真っ黒・ノイズになる

生成はされるのに、画像が真っ黒だったり、色化けや砂嵐のようなノイズになる場合、最初に疑うのはVAEです。

もっとも多いのが、Stable Diffusion用の汎用VAEを流用してしまっているケースです。Z-Imageでは専用のae.safetensorsを使う必要があり、別のVAEを差すと出力が壊れます。

まず確認する1点は、VAEとして専用のae.safetensorsが読み込まれているかどうかです。

それでも直らないときは、ファイルが途中までしかダウンロードされておらず破損している可能性があります。ファイルサイズが配布元の表記と合っているかを確かめ、合わなければ再ダウンロードしてください。ステップ数やCFGを極端な値にしている場合も画質が崩れるため、標準的な設定に戻して切り分けます。

③プロンプトが反映されない

プロンプトを変えても結果が変わらない、内容が無視されるといった症状は、テキストエンコーダ周りが原因のことがほとんどです。

Z-Imageは、プロンプトの理解にQwen3-4B専用エンコーダ（qwen_3_4b.safetensors）を使います。これがtext_encodersフォルダに置かれていないと、プロンプトが正しく解釈されません。

まず確認する1点は、CLIPなど別のエンコーダを誤って指定していないかです。SDXL用のワークフローを流用すると、ここがCLIPのままになりがちです。

正しいエンコーダを配置・指定し直し、ComfyUIを再起動してから、もう一度同じプロンプトで試してください。

④起動しない・生成が始まらない

モデルは置いたはずなのに一覧に出てこない、実行しても何も起きない、という場合は、ComfyUIの読み込みタイミングが原因です。

ComfyUIは起動時にしかモデルフォルダを走査しません。そのため、ファイルを追加した直後はブラウザの更新だけでは認識されず、ComfyUI本体の完全な再起動が必要です。

まず確認する1点は、ファイルが正しいフォルダに、正しい名前で置かれているかです。前半の配置表ともう一度照らし合わせてください。

それでも見つからない場合は、ダウンロードが途中で止まってファイルが壊れている可能性があります。ファイルサイズを配布元と見比べ、必要なら入れ直してください。

⑤生成が極端に遅い

VRAMには余裕があるはずなのに生成が異常に遅い場合は、設定とメモリ状態を見直します。

よくあるのは、CPUへ処理を逃がすオフロードが不要に有効化されているケースです。VRAMが足りているのにオフロードが効いていると、わざわざ遅い経路で計算することになります。

まず確認する1点は、低VRAM向けの設定やオフロードが意図せず入っていないかです。

また、長時間連続で使っているとメモリが断片化し、だんだん遅くなることがあります。その場合は一度ComfyUIを再起動すると、もとの速度に戻ります。

VRAM別モデル精度の選び方

ここで、OOMを根本から避けるためのフォーマット選びを整理します。

Z-Imageは、同じモデルが重さの違う3つのフォーマットで配布されています。手元のVRAMに合わせて選ぶことで、メモリ不足の多くは未然に防げます。

基準は、公式が前提とするbf16の16GB級です。VRAMがそれより少ないなら、まずfp8を試し、それでも厳しければGGUF量子化版を選びます。

軽いフォーマットほど必要なVRAMは下がりますが、GGUFはComfyUI-GGUFなどの追加ノードが必要になる点だけ覚えておきましょう。

よくある質問

まとめ

最後に、症状から原因へたどり着く流れを振り返ります。

Z-Imageのトラブルの多くは、特別な裏技ではなく、部品と設定の食い違いを1つずつ正すことで解決します。

うまく動かないときは、まずこのチェックリストに戻ってきてください。落ち着いて症状から原因をたどれば、画像が出ない状態からはきっと抜け出せます。