glTF 示例文件 — 下载 glTF 2.0(内嵌式及 .gltf + .bin)
glTF 2.0 — GL 传输格式(JSON) · .gltf, .bin · MIME 类型 model/gltf+json
下载 glTF 示例文件,用来测试 glTF 2.0 的 JSON 形式。同一个带贴图的环面结(4,096 个三角形)提供加载器必须支持的两种布局:一种是单个 .gltf,几何数据和 PNG 以 base64 data URI 内嵌其中;另一种是通过相对路径引用外部 .bin 缓冲区和 .png 贴图的 .gltf——提供散装和 ZIP 打包两种形式。
另有一个带旋转和平移循环动画的内嵌式 .gltf。每个文件都以零错误、零警告通过 Khronos glTF Validator。如果你只需要一个能在网页查看器中加载的文件,请改用二进制 GLB 示例;.gltf 布局用于测试 JSON 解析、URI 解析和多文件上传。

下载 glTF 示例文件
| 文件 | 详情 | 大小 | 下载 |
|---|---|---|---|
sample-model-separate.gltf | 4,096 个三角形 · 2,193 个顶点 · 法线 · UV · 1 种材质 · 米,Y 轴朝上 | 3 KB | |
sample-animated-embedded.gltf | 1,024 个三角形 · 512 个顶点 · 法线 · 1 种材质 · 1 个动画 · 米,Y 轴朝上 | 28 KB | |
sample-uv-grid-texture.png | 512 × 512 | 37 KB | |
sample-model-gltf-bin-png.zip | 3 个条目 · 4,096 个三角形 · 2,193 个顶点 · 法线 · UV · 1 种材质 · 米,Y 轴朝上 | 95 KB | |
sample-model-separate.bin | — | 95 KB | |
sample-model-embedded.gltf | 4,096 个三角形 · 2,193 个顶点 · 法线 · UV · 1 种材质 · 米,Y 轴朝上 | 178 KB |
在命令行或 CI 中使用这些文件
每个 URL 都稳定不变并开放 CORS。在测试中固定 SHA-256,一旦测试夹具发生变化,你会立刻知道。
# 下载单个文件 curl -O https://pnb-freetoolsforweb.s3.us-east-2.amazonaws.com/samples/3d/gltf/sample-model-separate.gltf # 校验文件(上方每个文件都列出了 SHA-256) shasum -a 256 sample-model-separate.gltf # 所有示例文件的机器可读索引 curl https://pnb-freetoolsforweb.s3.us-east-2.amazonaws.com/samples/index.json | jq '.files[] | select(.format=="gltf")'
glTF 格式概览
| 全称 | glTF 2.0 — GL 传输格式(JSON) |
|---|---|
| 扩展名 | .gltf, .bin |
| MIME 类型 | model/gltf+json |
| 规范 | Khronos glTF 2.0(ISO/IEC 12113:2022) |
| 编码 | JSON + 二进制缓冲区(外部 .bin 或 base64 data URI) |
| 材质 | PBR 金属度-粗糙度 |
| 单位和坐标轴 | 米,Y 轴朝上,右手坐标系(由规范规定) |
| 验证 | Khronos glTF-Validator:0 错误,0 警告 |
用 glTF 示例文件测试什么
- 解析相对路径的 .bin 和贴图 URI
- 解码内嵌式 glTF 中的 base64 data URI
- 多文件模型上传与 ZIP 解压
- glTF JSON 模式验证
- 动画播放(节点旋转和平移)
- 通过阅读 JSON 检查模型
常见问题
.gltf 和 .glb 有什么区别?
数据模型相同,容器不同。.gltf 是 JSON,它指向二进制缓冲区和图像,这些数据既可以是单独的文件,也可以以 base64 形式放在 JSON 内。.glb 则把 JSON 和一个二进制缓冲区打包进单个小端序二进制文件,没有 base64 带来的额外开销。分发时用 GLB,需要阅读或编辑 JSON 时用 .gltf。
为什么我的查看器显示分离式 .gltf 时没有贴图?
因为它没能获取 sample-uv-grid-texture.png 或 sample-model-separate.bin。这两个文件是相对于 .gltf 自身的 URL 解析的。从本站加载时它们位于同一文件夹,可以正常工作;如果单独上传 .gltf,它就是不完整的——请使用 ZIP 打包文件或内嵌式文件。
这些文件使用什么单位和朝上轴?
glTF、GLB、OBJ、PLY、OFF、DAE 和 USDZ 为 Y 轴朝上、单位为米(环面结直径约 1.4 m)。STL 和 3MF 为 Z 轴朝上、单位为毫米,并按切片软件的习惯放置在 z = 0 上。FBX 为 Y 轴朝上、单位为厘米。每个文件的单位和朝上轴都列在其详情中,方便你检查导入器的缩放和旋转是否正确。
这些模型是从哪里来的?
由我们自己生成。脚本先用公式构建几何体(环面结、UV 球、立方体,以及用布尔建模库制作的支架),再按各格式规范逐字节写出文件。没有任何模型是下载、扫描或从他人模型转换而来的,因此可免费用于任何用途(包括商业用途),无需署名。
下载这些 glTF 文件安全吗?
安全。每个文件都由我们自己的开源脚本从零生成——没有抓取或用户上传的内容——不包含脚本、宏或可执行文件。本页公布了每个文件的 SHA-256,方便你校验收到的文件。
可以将这些 glTF 示例文件用于商业用途吗?
可以。它们可免费用于任何用途,包括商业产品、测试套件、演示和再分发,无需署名。不需要任何授权,也不必征求任何人的同意。
可以直接外链这些文件或在 CI 中使用吗?
可以。每个链接都是稳定的 HTTPS 直链,带有 Access-Control-Allow-Origin: * 和较长的缓存头,curl、wget、fetch() 和测试运行器都可以直接拉取。每个页面都链接了所有文件的 JSON 索引(见命令行部分)。
相关示例文件
支持 glTF 的免费工具
- JSON 格式化 — 格式化、压缩和校验 JSON,解析错误精确到行和列。在浏览器中运行,无需上传。
- Base64 编码 / 解码工具 — 把文本或文件编码为 Base64,把图片转成带 CSS 和 <img> 代码片段的 data URI,还能把 Base64 解码回可预览的文件。数据不会离开你的浏览器。
- 哈希生成器 — 用 MD5、SHA-1、SHA-256、SHA-384、SHA-512 和 CRC32 计算文本或文件的哈希值,校验校验和,或计算 HMAC。文件绝不离开你的设备。
发现问题,或者觉得哪里可以更好?每条消息我们都会阅读,并尽快修复。