projtex · Projection Texturing API

projtex · Projection Texturing API

根据文本提示词给 3D 网格贴图，返回带有一张烘焙颜色贴图的 GLB。为智能体和开发者打造，提供 REST API 和 MCP 端点。

由 townbox 在 Hugging Face 上制作。这些说明是 Mindket 根据它的 Space 页面和 README 写的，应用自己的文件和许可证在 Hugging Face 上。

简介

它是什么：projtex 是一个给 3D 网格上色的服务。给它一个网格和一段文字提示词，它就会返回同一个网格，并把颜色贴图烘焙进去，格式是 GLB 文件。在内部，它从虚拟相机渲染图像，对照几何形状检查，投射到网格上，再把混合结果烘焙进 UV。

适合谁：需要带贴图的 3D 素材又不想手工绘制的开发者和智能体构建者，以及想快速出第一稿的 3D 美术。

Industry | Who uses it | How they use it | Example
游戏开发 | 独立开发者 | 根据文字描述给道具贴图 | 描述一座房子模型的外墙、屋顶和门
网页 3D | 使用 three.js 的开发者 | 给从场景导出的 GLB 贴图 | 发送导出的 GLB，拿回带贴图的版本
智能体 | 智能体构建者 | 让智能体把服务当作一组工具来调用 | 智能体通过 texture_mesh 工具给网格贴图

如果你不处理 3D 网格，或者用不到烘焙贴图，可以跳过它。

用在哪里：

• 网页浏览器，用于这个 Space 的页面和内置文档
• 任何能调用该服务 API 的脚本或 REST 客户端
• MCP 客户端，通过该服务的远程 MCP 端点
• 装有 Docker 的 Windows、macOS 或 Linux，在你自己的电脑上运行副本

Use case | Who | What they get back
给网格贴图 | 开发者和美术 | 带一张烘焙颜色贴图和质量结论的 GLB
给地形和地面贴图 | 关卡构建者 | 带俯视颜色图的地面 GLB，外加一个含 splat 图和细节贴图的压缩包
添加 PBR 材质 | 3D 美术 | 基础色已去掉光照的 GLB，外加 metallicRoughness 贴图

如何设置：

• 浏览器，如果你只在线使用这个 Space
• Docker 以及带 pip 的 Python，如果你自己运行副本
• 一个 Hugging Face 令牌，示例把它放在 X-HF-Token 请求头里发送

1. 打开 Hugging Face 上这个 Space 的页面即可在线使用服务，不用安装任何东西。
2. 想在本地运行，先安装 huggingface_hub 包，再下载这个 Space 的文件。
3. 进入新文件夹，构建 Docker 镜像。
4. 运行镜像，并开放 7860 端口。

pip install -U huggingface_hub
hf download townbox/projection-texturing --repo-type space --local-dir projection-texturing
cd projection-texturing
docker build -t projection-texturing .
docker run -it -p 7860:7860 projection-texturing

如何使用：每次贴图都是一个异步任务。你提交任务，然后轮询它的状态，直到状态变成 done。状态里带有进度、质量摘要、文件链接和一份后续调用清单。

没有网格也能试：在任务内容里发送一个内置样例和一段提示词。

{"sample": "lantern", "prompt": "black wrought iron, weathered oak post, warm glass"}

Tool | What it does
texture_mesh | 根据提示词给网格贴图
texture_terrain | 生成地形和地面贴图
get_job | 报告任务状态，并附预览图
regenerate_views | 重做选定的相机视角
disable_views | 把选定的视角排除在结果之外
fill_gaps | 填补贴图中没覆盖到的地方
retouch | 修复、替换或放大局部区域
bake | 把各视角重新烘焙进网格
submit_view_image | 让你提供自己的图像

示例：你上传一个房子的 GLB，要求白色护墙板外墙、灰色瓦屋顶和深绿色的门。你轮询任务。状态变成 done 后，返回内容会列出带贴图的 GLB、一张联系表和一个质量结论。

新手与专家：如果你刚接触 3D，先用内置样例和一句简短的提示词。它不需要你自己的网格，所以你能看到一次完成的任务是什么样子。

对专家来说，背后有三个图像模型，通过 backend 字段选择：默认的 Qwen-Image-2.1-Turbo、完整的 Qwen-Image-2.1，以及 Bria Fibo 2.0 Edit Turbo。mock 后端提供免费的试运行，external 后端接收你自己的图像。覆盖率按相机能看到的部分来衡量，底面单独报告。代价是配额，因为每个视角会花掉调用方约 30 秒的 GPU 时间。

把网格和提示词作为任务提交
虚拟相机生成图像
每张图像对照几何形状检查
图像被投射并混合
结果被烘焙进 UV

注意事项：

• License: mit
• Cost to run: 图像生成会花掉你自己每天的 ZeroGPU 配额，每个视角约 30 秒，使用 mock 后端的试运行免费
• Data it reaches: 你上传的网格、公开的网格链接或内置样例，以及托管在其他 Hugging Face Space 里的图像模型
• Input formats: 网格以 GLB、glTF、OBJ、PLY 或 STL 文件的形式传入，也可以放在压缩包里

Title: 每个模型的生成步数
Qwen-Image-2.1-Turbo: 8 步
Qwen-Image-2.1: 40 步

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

• 点赞：5
• 构建方式：docker
• 许可证：mit

链接

• Space：https://huggingface.co/spaces/townbox/projection-texturing
• 文件：https://huggingface.co/spaces/townbox/projection-texturing/tree/main

试用

在浏览器里打开这个 Space，或在它的页面上把它复制到你自己的 Hugging Face 账号。这个工具包里没有会自己运行的东西。