本機圖像與影片生成
gamedev pkg add aigd.sdcpp總覽
使用 stable-diffusion.cpp 在這台電腦上生成圖像、材質與短影片:NVIDIA(CUDA)、AMD 與 Intel(Vulkan)、Apple 晶片(Metal)或處理器。新增「圖像生成」與「影片」工具。模型是獨立套件(Z-Image Turbo、FLUX、SDXL、Qwen-Image、LTX-2.5、Wan 2.2 等)。
讓 AI Game Dev 在這台電腦上,用你自己的 GPU(或是對在處理器上實測的模型,改用它的處理器),透過 stable-diffusion.cpp 生成圖像、材質與短影片的執行環境。一切都在你的電腦上製作,而且完全不花錢。它是下方每個本機圖像與影片模型套件背後的引擎:安裝一次,之後再加入適合你的電腦與遊戲的模型。
這個套件只有資料(aigd-package.json,沒有程式碼)。它告訴 AI Game Dev 要為你的電腦下載哪一個 stable-diffusion.cpp 版本,並在工作階段的工具列加入兩個開關:圖像生成與影片。兩者在工作階段中都要由你開啟才會啟用。應用程式會自行下載、檢查並執行這支程式。
功能
- 為你的電腦下載正確的 stable-diffusion.cpp 組建(NVIDIA CUDA、適用於 AMD / Intel / 其他 GPU 的 Vulkan、Apple 晶片 Mac 上的 Metal,或處理器),並以 sha256 檢查。
- 讓代理用你安裝的模型套件製作圖像(文字轉圖像、圖像轉圖像、編輯)與短片(文字轉影片、圖像轉影片)。
- 當你沒有指定模型時,挑選已下載且最適合你這台電腦的模型(預設模型與預設影片模型設定可覆寫此選擇)。
- 為圖像與短片執行同一個共用佇列(見下文),並可選擇設定生成時間上限與 GPU 記憶體預算。
模型是獨立套件
這個套件不含任何模型。請從套件瀏覽器安裝模型套件(例如 aigd.image-z-image-turbo,短片則例如 aigd.video-ltx25 / aigd.video-wan22-ti2v-5b),然後在模型面板下載它的檔案。未經你確認不會下載任何東西,而且你會先看到大小——代理要求模型時也一樣。
圖像模型
| 套件 | 最適合 | 電腦 |
|---|---|---|
| Z-Image Turbo | 快速的擬真與插畫圖像、短文字 | NVIDIA 4 GB+,其他 GPU 8 GB+,整合式 GPU(較慢) |
| FLUX.1 schnell | 以 4 步生成插畫、照片、圖示、Sprite | NVIDIA 8 GB+ |
| FLUX.2 klein 4B | 插畫、圖示、Sprite | Apple 晶片 Mac |
| SDXL 1.0 | 一般插畫、概念美術、照片 | NVIDIA 8 GB+ |
| Animagine XL 4.0 | 動漫角色與插畫 | NVIDIA 8 GB+ |
| Juggernaut XL v9 | 電影感的擬真圖像 | NVIDIA 8 GB+ |
| RealVisXL V5.0 | 擬真的人物、場景、產品 | NVIDIA 8 GB+ |
| Qwen-Image | 文字呈現、UI mockup、海報 | NVIDIA 16 GB+, 32 GB RAM |
| Qwen-Image-2512 | 文字呈現與提示詞遵循,20 步 | NVIDIA 16 GB+, 32 GB RAM |
| Qwen-Image-2512 Lightning | 同樣內容,4 步完成 | NVIDIA 16 GB+, 32 GB RAM |
| Qwen-Image-Edit-2511 | 依指示編輯圖像,20 步 | NVIDIA 16 GB+, 32 GB RAM |
| Qwen-Image-Edit-2511 Lightning | 同樣內容,4 步完成 | NVIDIA 16 GB+, 32 GB RAM |
| Qwen-Image-2.1 Turbo Q3 | 透明背景(非商業用途) | NVIDIA 6–8 GB, 16 GB RAM |
| Qwen-Image-2.1 Turbo | 透明背景(非商業用途) | NVIDIA 8 GB+,16 GB RAM;或 Windows PC 的處理器 |
| Qwen-Image-2.1 Turbo Q8 | 透明背景(非商業用途) | NVIDIA 12 GB+, 24 GB RAM |
影片模型
| 套件 | 最適合 | 電腦 |
|---|---|---|
| LTX-2.5 | 含同步音效、文字或起始畫面的短片 | NVIDIA 16 GB+, 48 GB RAM |
| Wan 2.2 TI2V 5B | 無音效的短片,開放授權 | NVIDIA 12 GB+, 16 GB RAM |
每個模型套件都會註明自己的授權條款,以及實測所在的電腦。
範例指令
- 「開啟圖像生成,做一個銀色鑰匙的道具欄圖示。」
- 「用本機圖像模型畫一張沙漠峽谷的概念圖。」
- 「做一段 5 秒的標題畫面場景短片,有風聲和遠處的雷聲。」
一個佇列,一顆 GPU
圖像與短片共用同一個佇列和一顆 GPU,同一時間只會載入一個模型。載入模型需要一段時間,所以只要已載入的模型還有工作等著,它就會繼續佔用 GPU,圖像和短片都一樣。等到已載入的模型沒有事情可做,或另一個模型的工作已等待至少 5 分鐘,才輪到另一個模型。接著由工作等待最久的模型取得下一次機會。切換模型絕不會中斷已在執行的圖像或短片:它會先完成。只有在你停止它、達到你設定的生成時間上限,或代理取消短片時,它才會提早停止。
會下載哪些東西
上游發行版,以標籤釘住並以 sha256 檢查:leejet/stable-diffusion.cpp master-1106-532d2c1。Linux 版本則維持在 master-929-3f8527a:上游自該版本起在 Ubuntu 26.04 上建置 Linux,而那些執行檔需要 glibc 2.43。應用程式會為你的電腦挑選一種版本。你可以用 backend 設定變更它。
| 版本 | 電腦 | 下載 |
|---|---|---|
win-x64-cuda12 | Windows,NVIDIA GPU(驅動程式 572.61 或更新,compute capability 6.1 或更新) | 976 MB(程式 + NVIDIA CUDA runtime) |
win-x64-vulkan | Windows,AMD / Intel / 其他 GPU | 30 MB |
win-x64-cpu | 沒有可用 GPU 的 Windows:處理器。速度慢(在快速桌機上每張 512 px 圖像約一分鐘,筆電上則要數分鐘),且僅適用於在該環境實測過的模型(Qwen-Image-2.1 Turbo) | 18 MB |
darwin-arm64-metal | Apple 晶片 Mac,macOS 26 或更新版本 | 38 MB |
linux-x64-vulkan | Linux x64 搭配 Vulkan GPU,glibc 2.38 或更新版本(Ubuntu 24.04+、Debian 13+)。需要安裝 libgomp.so.1 與 libvulkan.so.1 | 37 MB |
只要 GPU 版本能執行,就絕不會選用 CPU 版本;若仍要使用,請在模型面板把後端選為 CPU。
文字編碼器。 模型中用來讀取提示詞的部分,可以跑在 GPU 或處理器上(textEncoder 設定,模型面板中的 Text encoder)。Auto 會保留各模型實測時的設定:Qwen-Image-2.1 Turbo Q3 與 Wan 2.2 把它放在處理器上,以配合其顯示卡的容量。CPU 可釋出約 2 GB 顯示記憶體,代價是每張圖像多一、兩秒;GPU 在顯示卡還有空間時稍快一些,但對於實測時放在處理器上的模型,可能會記憶體不足。
Linux 為預覽版。 Linux 組建尚未在真實的 Linux GPU 上測試過。它可以被選取,並標示為「預覽」。
應用程式絕不會安裝驅動程式或系統函式庫。如果有缺少的東西,它會告訴你要安裝什麼。
授權條款
- stable-diffusion.cpp — MIT,© leejet(授權條款)。
- ggml — MIT(上游提供的是 ggml-org/ggml 的分支 leejet/ggml)。
- NVIDIA CUDA runtime(cudart、cuBLAS),僅含於 Windows CUDA 版本 — 由上游依 NVIDIA CUDA EULA 再散布。
- NVIDIA CUTLASS,僅含於 Windows CUDA 版本 — BSD-3-Clause(授權條款)。
- 本套件 — MIT。每個模型套件都會註明自己的授權條款。
所有檔案都從上游的 GitHub 發行版下載。AI Game Dev 不代為托管。
版本
| 版本 | 發布日期 | 需搭配應用程式 |
|---|---|---|
| 1.3.1最新 | 0.20.0 或更新版本 | |
| 1.3.0 | 0.20.0 或更新版本 | |
| 1.2.0 | 0.20.0 或更新版本 | |
| 1.1.3 | 0.20.0 或更新版本 | |
| 1.1.2 | 0.20.0 或更新版本 | |
| 1.1.1 | 0.20.0 或更新版本 | |
| 1.1.0 | 0.20.0 或更新版本 | |
| 1.0.1 | 0.20.0 或更新版本 | |
| 1.0.0 | 0.20.0 或更新版本 |
安裝
在桌面應用程式中
開啟 套件 視窗(狀態列上的套件圖示),選擇 瀏覽,搜尋 aigd.sdcpp,然後點選 加到專案。
還沒安裝應用程式?免費下載 AI Game Dev,支援 Windows、macOS 與 Linux。
從終端機
在你的專案資料夾中,使用 gamedev CLI:
gamedev pkg add aigd.sdcpp需求
- AI Game Dev 0.20.0 或更新版本
- 搭載 Apple 晶片的 Mac
gamedev pkg add aigd.sdcpp