Spark-X2.6-4B-Blender

Spark-X2.6-4B-Blender

编写 Blender 5.x 的 Python 脚本，生成干净的、以四边形为主的网格，比如道具、家具、产品以及人体和动物的基础网格。这是 Spark-X2.6-4B-Base 的 4B 微调版本，适合用脚本操作 Blender 的人。

由 hotocooo 在 Hugging Face 上制作。这些说明是 Mindket 根据它的模型页面和模型卡写的，模型自己的文件和许可证在 Hugging Face 上。

简介

它是什么：Spark-X2.6-4B-Blender 是一个小型 4B 模型，把描述变成面向 Blender 5.x 的 bpy 脚本。运行脚本会得到一个整洁的、以四边形为主的网格，比如硬表面道具、家具、产品，以及人体、手和四足动物的基础网格。它是 Spark-X2.6-4B-Base 的全参数微调版本，训练了全部 4.1B 权重，没有用适配器。

适合谁：它适合想把生成的初始网格当作可运行、可编辑的脚本的 Blender 用户和 3D 开发者。模型卡的训练只保留了在 Blender 里跑通并产出几何体的脚本。

Title: 谁在用
Industry | Who uses it | How they use it | Example
3D 设计 | Blender 创作者 | 生成可以再编辑的基础网格脚本 | 手的基础网格
产品设计 | 产品团队 | 用代码起草简单的产品形状 | 一个小型家居产品
游戏开发 | 道具建模师 | 快速用脚本生成家具和道具 | 一张桌子或一把椅子

如果你需要精确尺寸或满足硬性约束，可以跳过它。模型卡的约束测试得分是 0.0%。

用在哪里：

• Blender 5.x，生成的脚本在这里运行，模型卡在 5.2.1 LTS 上测试过
• transformers 库，在装有 Python 的 Windows、macOS 或 Linux 上
• 无界面的 Blender 运行，模型卡所有测量都是这样做的

Title: 它能做的事
Use case | Who | What they get back
硬表面道具 | 3D 创作者 | 构建道具的 bpy 脚本
家具和产品 | 产品建模师 | 生成干净的、以四边形为主的网格的脚本
有机体基础网格 | 角色创作者 | 比例合理的人体、手或四足动物基础网格

如何设置：

• Windows、macOS 或 Linux 上的 Python
• Blender 5.x，用来运行模型写出的脚本
• 能放下约 8.2 GB BF16 权重的内存

1. 安装 Hugging Face Hub 工具。
2. 下载模型文件。
3. 用 transformers 加载模型，然后在 Blender 里运行它的脚本。

pip install -U huggingface_hub
hf download hotocooo/Spark-X2.6-4B-Blender

如何使用：
描述你想要的物体，让模型写一个 bpy 脚本，然后在 Blender 里运行脚本并检查网格。模型卡的所有测量都是在 Blender 5.2.1 LTS 里无界面运行脚本、用贪心解码得到的。可见文本里没有给出提示词格式。

hf download hotocooo/Spark-X2.6-4B-Blender

示例：
你要一张简单的四腿桌子，以 Blender 脚本的形式给出。模型返回一个 bpy 脚本。你在 Blender 里运行它并检查网格。模型卡按脚本是否跑通、拓扑分数和与参考的保真度来给这类输出打分。

新手与专家：
如果你是新手，这个模型写的是在 Blender 里生成 3D 形状的代码，之后你再去编辑这个形状。第一件小事是要一个简单的道具，并运行它返回的脚本。

如果你懂这个领域，训练只保留了在 Blender 里无界面跑通并生成几何体的脚本，并对网格的拓扑打分。模型卡记录了从第一次全量微调到拒绝采样再到 DPO 的各个阶段。代价在范围：没见过的任务和约束类任务得分接近零，在所列阶段里 3DCode 保留集上只有 30% 到 42% 的脚本能运行。

描述你想要的形状
模型写出 bpy 脚本
在 Blender 5.x 里运行脚本
检查网格和拓扑

注意事项：

Title: BlendNet 保留集上能运行的脚本占比
Untuned base: 2.0 %
v1: 99.0 %
v3: 100.0 %
v3d: 100.0 %
v3dr: 98.0 %

• 指标：run 表示脚本生成了几何体，topo 是最高 1.0 的拓扑分数，fid 是与参考的保真度。
• 弱点：在模型卡列出的阶段里，精确尺寸和硬性约束测试得分是 0.0%。
• 阶段：模型卡列了 v1 到 v7 和 DPO 变体，可见文本没有说这个仓库是哪一个。
• 人体结构：基础模型在没见过的人体结构上运行率是 0.0%，微调后的阶段达到 100.0%。
• License：apache-2.0。
• Cost to run：没有提到 API 密钥、账号或付费服务。
• Data it reaches：它从 Hugging Face 下载文件，它写的脚本在你的 Blender 里运行。
• Not for：需要精确尺寸或硬性约束的任务。

Hugging Face 上的数据（2026年11月13日）

• 任务：text generation
• 框架：transformers
• 参数量：4.1B
• Weights: about 8.2 GB in BF16; about 2.1 GB at 4-bit (estimate)
• Formats: Safetensors
• 最近 30 天下载：730
• 点赞：3
• 许可证：apache-2.0
• 语言：en
• 基于：XHToken/Spark-X2.6-4B-Base
• Quantized versions: 1
• 标签：transformers, safetensors, spark2_5, text-generation, blender, 3d-modeling, 3d, topology, mesh, retopology, anatomy, code-generation

链接

• 模型：https://huggingface.co/hotocooo/Spark-X2.6-4B-Blender
• 文件：https://huggingface.co/hotocooo/Spark-X2.6-4B-Blender/tree/main

获取模型

用 Hugging Face 的命令行下载它的文件：

pip install -U huggingface_hub
hf download hotocooo/Spark-X2.6-4B-Blender

然后按它的模型卡使用它。这个工具包里没有会自己运行的东西。