在线体验 关于项目
档案馆收录亚历山大女皇鸟翼凤蝶、荷马凤蝶等六种濒危蝴蝶:每种都有可拖拽旋转的 3D 标本,配上保护等级(IUCN / CITES)、分布区域、栖息地与主要威胁的通俗科普,支持按名称与保护等级检索筛选。
站内直接接入 Tripo API:每个物种都配好了建模提示词,一键复制、或当场发起文本生 3D 任务并轮询出件;参考图与模型文件也提供下载——把「看标本」变成「造标本」。
体验要点
- 六种濒危蝴蝶标本可拖拽旋转,360° 端详翅面细节
- 按名称与保护等级(IUCN / CITES)检索筛选物种
- 每个物种自带调好的建模提示词,一键复制
- 站内直连 Tripo API:当场发起文本生 3D 任务并轮询出件,参考图与模型文件可下载
技术解析
Tripo API 接入 · 文本生 3D 任务管线
整个 Tripo 接入被收在一个独立的 service 文件里,流程走下来只有三步:先用 Bearer Key 完成鉴权;再带着物种提示词创建文生 3D 任务(打开 texture 和 pbr,纹理质量选 standard);最后每 4 秒查一次任务状态——生成完成就拿到模型的下载直链,失败、取消和超时也都有兜底处理。
这几十行代码就是一份现成的接入模板:鉴权、建任务、轮询、取结果。抄到你自己的项目里,换个 API Key 就能跑。
提示词工程 · 每物种一份出件配方
六个物种各自带着一份反复调过的建模提示词,套路可以拆成三段:先把形态说清楚(雄性背视、翅脉走向、腹部配色),再排除不想要的效果(要哑光、不要金属感和虹彩反光),最后交代出件要求(薄翼、干净拓扑、PBR 纹理)。每份提示词都能在站内一键复制——它们才是这座档案馆最值得带走的「源代码」。
标本展示 · 程序化形体 + 多格式出件
页面上可以拖拽把玩的蝴蝶,是用 Three.js 程序化拼出来的轻量形体(一对翅膀、标准材质加半球光),不依赖任何外部资产就能跑起来。想要更精细的版本,每个物种都附带 Tripo 生成的 PBR FBX 和基础 OBJ 文件可以下载,预览图就是 Tripo 的渲染结果——线上看交互、下载拿资产,两边互不耽误。
档案系统 · React 数据驱动
物种档案里的保护等级(IUCN / CITES)、分布、栖息地、威胁,全部由数据驱动渲染,检索和筛选直接在前端完成,不需要后端。技术栈就是 React 19 加 Vite 8,构建出来是纯静态文件,随便找个静态托管一放就能上线。


