Qwen3.5-4B-3D-Html

Qwen3.5-4B-3D-Html

一个 4.2B 的文本生成模型，由 Qwen3.5-4B 微调而来，用 Three.js 把 3D 场景写成一个独立的 HTML 文件。在浏览器里打开文件，用鼠标旋转模型。

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

简介

它是什么：Qwen3.5 4B 3D Html 是一个由 Qwen3.5-4B 微调而来的小型文本生成模型。它把 3D 场景写成一个用 Three.js 构建的独立 HTML 文件。你描述一个物体，把回复保存成网页，在浏览器里打开。模型卡说不需要额外安装库。设定好的系统提示要求白色背景、没有按钮或文字、滚轮缩放、鼠标右键旋转。

适合谁：它适合想根据文字描述快速得到 3D 预览的网页开发者、老师和创作者，也适合用代码生成的 3D 来测试小模型的人。

行业 | 谁在用 | 怎么用 | 例子
网页开发 | 前端开发者 | 把 Three.js 场景生成为一个文件 | 请它做一个简单的物体，并在浏览器里打开文件
教育 | 3D 图形老师 | 展示一个形状如何用代码构建 | 生成一个形状并阅读它的 Three.js 代码
爱好和原型 | 创作者 | 快速勾勒 3D 想法 | 请求一个小物体，并用鼠标右键旋转它

如果你需要精致、细节丰富的模型或精确的结果，可以略过它。模型卡说它会出小错误，而且训练数据很少。

用在哪里：

• 能运行 Safetensors 或 GGUF 模型的运行器，因为仓库两种都有
• 网页浏览器，用来打开生成的 HTML 文件
• 内存足够的电脑，BF16 下约 8.4 GB，4 位下约 2.1 GB，这只是估算值
• 装有 Python 的 Windows、macOS 或 Linux，用来下载文件

用途 | 谁用 | 能得到什么
文字生成 3D 场景 | 创作者 | 一个包含 Three.js 场景的 HTML 文件
快速原型 | 开发者 | 一个可以编辑的起点
教学 | 老师 | 一个简单 3D 物体的易读代码

如何设置：
你需要先准备：

• Python 和 Hugging Face 命令行
• 运行模型的办法，可以用 Safetensors 文件，也可以用模型卡列出的 Q6_K GGUF 文件
• 放权重的空间

1. 下载模型文件。
2. 在你的运行器里加载模型，并设置模型卡里的系统提示。
3. 应用采样设置，并把输出 token 的上限设得高一些。

pip install -U huggingface_hub
hf download mondk/Qwen3.5-4B-3D-Html

如何使用：
设置下面的系统提示，然后在你的消息里描述想要的物体。模型会回复一个 HTML 文件。把它保存成 html 结尾的文件，在浏览器里打开。滚动滚轮缩放，按住鼠标右键旋转。

You are a text-to-3D model generator. You will write a single HTML file using Three.js to create a 3D model.
The output must be a single, self-contained HTML file (all JavaScript and CSS inline in that one file). Return only the complete HTML code.
Load Three.js and OrbitControls from a CDN (e.g. cdnjs or jsDelivr) using a pinned version.
The background must be white.
Do not add any additional elements (buttons, text, etc.) to the interface; the view should be exclusively for observing the 3D model.
Controls: Use the scroll wheel to zoom in/out, and the right mouse button to rotate the camera.

Title: 模型卡推荐的采样设置
设置 | 值
Temperature | 0.65
Top P | 0.95
Top K | 30
Repeat penalty | 1.05

工具 | 作用
Three.js | 在浏览器里绘制 3D 场景
OrbitControls | 让你用鼠标缩放和旋转视图
系统提示 | 告诉模型返回一个独立的 HTML 文件

示例：你设置模型卡的系统提示，让模型做一个简单的物体。它会写出一个 HTML 文件。你保存它，在浏览器里打开，并用鼠标右键转动这个物体。

新手与专家：第一次尝试可以选一个简单的物体，这样答案比较短，也容易检查。在要求修改之前，先在浏览器里打开文件。

对懂行的人来说，作者用 QLoRA 对模型训练了 3 个 epoch。bf16 类型不受支持，而用 fp32 做完整微调又太慢。数据集被描述为质量好但规模小。提示要求内联的 JavaScript 和 CSS、从 CDN 加载固定版本的 Three.js 和 OrbitControls、白色背景，并且没有多余的界面元素。作者说之后计划发布带有修复和更广 3D 主题的检查点。

你设置系统提示并描述一个物体
模型用 Three.js 写出一个 HTML 文件
你保存文件并在浏览器里打开
滚动缩放，右键拖动旋转

注意事项：

Title: 模型信息
项目 | 数值
参数量 | 4.2B
BF16 权重 | 约 8.4 GB
4 位权重 | 约 2.1 GB，估算值
格式 | Safetensors 和 GGUF
基于 | Qwen3.5-4B
语言 | 英语

• 输出很长：模型写得很多，所以要把 max_tokens 上限设得高一些。
• 循环：它在命名变量时可能卡住。遇到这种情况，就停止运行，让它转到搭建部分。
• 错误：它可能在旧版库或步骤顺序上出错。指出来，它可以改正。
• 训练：数据集很小，作者用了 QLoRA。
• 模型卡语言：作者说模型卡是机器翻译的，所以有些地方可能不清楚。
• License: apache-2.0
• Cost to run: 没有提到 API 密钥或付费服务。
• Data it reaches: 它从 Hugging Face 下载文件。模型卡的提示让页面从 CDN 加载 Three.js，所以打开它大概需要联网。
• Not for: 精确或细节极多的模型。

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

• 任务：text generation
• 参数量：4.2B
• Weights: about 8.4 GB in BF16; about 2.1 GB at 4-bit (estimate)
• Formats: Safetensors, GGUF
• 最近 30 天下载：1,735
• 点赞：5
• 许可证：apache-2.0
• 语言：en
• 基于：Qwen/Qwen3.5-4B
• Quantized versions: 1
• 标签：safetensors, gguf, qwen3_5_text, 3d, html, text-generation, conversational

链接

• 模型：https://huggingface.co/mondk/Qwen3.5-4B-3D-Html
• 文件：https://huggingface.co/mondk/Qwen3.5-4B-3D-Html/tree/main

获取模型

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

pip install -U huggingface_hub
hf download mondk/Qwen3.5-4B-3D-Html

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