# Animagine XL 4.0（图像模型）

> 动漫风格的插画与角色（Cagliostro Research Lab 微调的 SDXL），本地运行：角色立绘、服装概念图和动漫主视觉图。用逗号分隔的标签写提示词。支持文生图和图生图。生成的图像允许商用（CreativeML Open RAIL++-M）。需要 8 GB 及以上的 NVIDIA GPU。

- ID: `aigd.image-animagine-xl-4`
- 来源: 官方 (第一方 `aigd.*`)
- 分类: 图像模型
- 发布者: AI Game Dev (`aigd`), 已验证
- 最新版本: 1.0.4 (发布于 2026-11-22)
- 许可证: SEE LICENSE IN README.md
- 需要 AI Game Dev 应用: `>=0.25.0`
- 原生代码: 否
- 评分: 暂无评分
- HTML 页面: https://ai-game.dev/zh-hans/packages/aigd.image-animagine-xl-4

## 安装

使用 gamedev CLI，在项目文件夹中运行：

```bash
gamedev pkg add aigd.image-animagine-xl-4
```

在桌面应用中：打开 Packages 窗口（状态栏中的包图标），选择 **Browse**，搜索 `aigd.image-animagine-xl-4`，然后点击 **Add to Project**。更多：https://ai-game.dev/docs/wiki/app/packages

## 版本

| 版本 | 发布时间 | 需要应用 | 备注 |
|---|---|---|---|
| 1.0.4 | 2026-11-22 | `>=0.25.0` | 最新 |
| 1.0.3 | 2026-11-06 | `>=0.25.0` | - |
| 1.0.2 | 2026-10-13 | `>=0.25.0` | - |
| 1.0.1 | 2026-10-12 | `>=0.25.0` | - |

## 描述

````markdown
# Animagine XL 4.0 (`aigd.image-animagine-xl-4`)

**Animagine XL 4.0** 由 Cagliostro Research Lab 出品，是基于 Stable Diffusion XL（SDXL）微调的动漫风格模型，擅长插画与角色。在 AI Game Dev 中，它通过**本地图像生成**（[`aigd.sdcpp`](https://ai-game.dev/packages/aigd.sdcpp)）在你自己的 NVIDIA GPU 上本地运行，所以生成图像不花钱，图像也从不会离开你的电脑。它适合动漫或漫画风格的游戏：视觉小说、JRPG、抽卡风格的角色美术以及类似项目。

你要用逗号分隔的**标签**来写提示词（“1girl, silver hair, armor, castle, masterpiece, high score, absurdres”），而不是句子。它不是纹理模型，也不渲染文字。

## 你可以制作什么

- 动漫风格的角色立绘和全身角色美术。
- 为一组角色设计角色概念和服装变体。
- 用于菜单、加载界面和商店页面的动漫风格插画和主视觉图。
- 对已有图片做变体（图生图）。

它不适合做可平铺纹理、UI 文字、标志或照片级写实图像：文字请用 [Qwen-Image-2512](https://ai-game.dev/packages/aigd.image-qwen-image-2512)，照片请用 [RealVisXL V5.0](https://ai-game.dev/packages/aigd.image-realvisxl-v5)。

## 示例请求

- “用 Animagine 画我们的女主角：1girl, silver hair, armor, castle, masterpiece, high score, absurdres。”
- “用 Animagine 给我们的女主角做三套服装变体：1girl, silver hair, summer dress / winter coat / battle armor, masterpiece, high score。”
- “标题画面的动漫主视觉图：1boy, 1girl, sword, cherry blossoms, sunset, masterpiece, high score。”
- “把这张草图重绘成干净的动漫插画”（基于你的图片做图生图）。

## 亮点

|  |  |
|---|---|
| 基础模型 | SDXL 微调（动漫） |
| 操作 | 文生图、图生图 |
| 提示词风格 | 逗号分隔的标签；模型卡把质量标签（`masterpiece, high score, great score, absurdres`）放在末尾 |
| 默认尺寸 | 1024×1024（最高 1536×1536） |
| 参数设置 | 28 步，引导强度 5，Euler ancestral 采样器（模型卡所给）；开启 flash attention |
| 文件 | 一个文件，内含自动编码器和两个文本编码器 |
| 图像商用 | 允许（见许可协议） |

## 适用电脑

| 电脑 | 速度 |
|---|---|
| 8 GB 及以上的 NVIDIA GPU（CUDA） | 约 8 秒（1024²，28 步） |

在 RTX 4090 上实测——只是估算，并非保证。尚未在 Vulkan（AMD、Intel、Linux）或 Apple GPU 上测试，因此暂不支持这些平台。

## 下载

本包只包含数据。它列出模型文件；应用在你确认后下载这些文件，用 sha256 逐一校验，并用 stable-diffusion.cpp 在你的电脑上运行它们。

6.94 GB，一个文件，固定到某个 Hugging Face 提交。

| 文件 | 来源 | 大小 |
|---|---|---:|
| `animagine-xl-4.0-opt.safetensors`（模型、自动编码器和文本编码器合于一个文件） | [`cagliostrolab/animagine-xl-4.0`](https://huggingface.co/cagliostrolab/animagine-xl-4.0) | 6.94 GB |

## 许可协议

[CreativeML Open RAIL++-M](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/blob/main/LICENSE.md)，与 SDXL 相同，未作改动，如模型卡所述。你生成的图像允许商用；该许可协议禁止一系列有害用途（其附件 A）。

- Animagine XL 4.0 © Cagliostro Research Lab —— [模型卡](https://huggingface.co/cagliostrolab/animagine-xl-4.0)，CreativeML Open RAIL++-M。
- Stable Diffusion XL base 1.0 © Stability AI —— [模型卡](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0)，CreativeML Open RAIL++-M。

所有文件均从 Hugging Face 下载。AI Game Dev 不托管这些文件。
````
