~/教學/ORBIT.md

文章 / 做 App

Claude 做不出 3D 模型?免費拿一個(Hunyuan3D 2.1),再請它用 three.js 接成會轉的網站

Claude 做不出有貼圖的 3D 模型,但會寫 three.js。用騰訊的 Hunyuan3D 2.1 免費把照片變成 GLB,再用三段提示詞請 Claude 規劃、載入模型、把鏡頭綁到捲動。

Claude 會寫 three.js,但它做不出一個有細節、有貼圖的 3D 模型。解法是分工:模型去免費的地方拿,網站交給 Claude 接。這篇把 Reels 裡 ORBIT 那支的三個步驟寫完整:去哪裡免費拿模型(騰訊的 Hunyuan3D 2.1 和它的官方線上版)、請 Claude 規劃和動手的三段提示詞,還有我實際跑過的 three.js 程式裡最關鍵的兩段。

01先看成果:捲動一下,模型就轉一圈

示範頁的最上面:左邊是 BOOMBOX 88 的大標題,右邊是一台 3D 收音機
我這次做的示範頁(真實畫面)。品牌是虛構的。
同一頁往下捲到「01 雙喇叭」,收音機轉到側面
往下捲,文字照常走,右邊的模型跟著轉;捲到底剛好一圈。

這是一台收音機的產品頁。整頁只有一個 index.html 加一個 70 行的 main.js,沒有用任何框架。往下你會拿到:① 免費拿模型的地方和它的限制 ② 請 Claude 先寫 plan.md 的提示詞 ③ 請它寫 three.js、載入模型的提示詞 ④ 把鏡頭綁到捲動的提示詞,還有我實際跑過的那兩段程式。

02第一步:免費拿一個 3D 模型(Hunyuan3D 2.1)

Hunyuan3D 2.1 是騰訊放出來的 3D 生成模型:給它一張物體的照片,它先生出形狀,再貼上材質。官方 README 寫它是 Fully Open-Source Framework,模型權重和訓練程式碼都放出來了,使用不收授權費(但有地區限制,看下面的提醒)。

Hunyuan3D-2.1 的 GitHub README:Fully Open-Source Framework,模型權重和訓練程式碼都公開
官方 README:模型權重和訓練程式碼都公開。

最省事的是官方的免費線上版,開在 Hugging Face 上。下面的按鈕名稱是我從官方 repo 的 gradio_app.py 讀來的;我沒有實際在線上版跑過生成,畫面可能略有不同。

  1. 打開官方的 Hugging Face Space(連結在下面),它是騰訊自己的帳號開的。
  2. 在 Image Prompt 把照片拖進去。挑背景乾淨、只有一個物體的照片。
  3. 官方程式裡有兩顆按鈕:Gen Shape(只生形狀)和 Gen Textured Shape(形狀加材質)。要放上網站,選有材質的。
  4. 生成好之後,在匯出的地方把 File Type 選成 glb,按 Transform,再按 Download。
  5. 把檔案改個好記的名字,例如 radio.glb,放進你的專案資料夾。
Hugging Face 上的 tencent/Hunyuan3D-2.1 Space,顯示 Running on ZERO 和 Image Prompt 上傳區
官方的免費線上版(2026 年 11 月 9 日的畫面)。

想在自己的電腦跑也可以,但門檻不低。README 寫得很直接:只生形狀要 10 GB,材質要 21 GB,兩個一起要 29 GB 的顯示記憶體。

README 的 Models Zoo:形狀 10 GB、材質 21 GB,形狀加材質一共 29GB 的 VRAM
官方 README 的硬體需求:形狀加材質一共 29 GB。

03第二步:請 Claude 先規劃

拿到模型之後,先不要叫 Claude 直接寫程式。先請它把網站寫成一份 plan.md:有哪些區塊、怎麼捲、什麼東西會動。這一步很短,但它之後會照著做,你要改方向,也只要改這份文件。

請 Claude 先規劃(把[]換成你的內容)
我要做一個單頁的產品頁,主角是一個 3D 模型(檔案是[radio.glb],已經放在專案資料夾裡)。
產品是[一台復古收音機],風格是[米色背景、粗體大標題]。
先不要寫程式。請先寫一份 plan.md,分三段:
1. 區塊:整頁由上到下有哪幾個區塊,每個區塊一句話說明
2. 捲動:頁面怎麼捲,3D 畫布要固定還是跟著捲
3. 什麼會動:捲動的時候,鏡頭或模型怎麼動、動多少
最後列出技術選擇:只用 three.js 和 GLTFLoader,不用框架。
寫完先給我看,我說可以再動手。
plan.md 的內容:區塊有五個,捲動時文字跟著走、3D 畫布固定,鏡頭繞著模型轉,捲到底剛好一圈
我拿到的 plan.md:五個區塊、畫布固定、鏡頭繞模型一圈。

04第三步:請 Claude 寫 three.js,用 GLTFLoader 載入模型

規劃沒問題,就請 Claude 照著寫。three.js 讀 GLB 檔用的是 GLTFLoader,它是 three.js 內建的 glTF 2.0 載入器。先只求一件事:模型出現在頁面上。

請 Claude 動手(接在規劃後面,把[]換成你的檔名)
照 plan.md 做。請產生 index.html 和 main.js:
- three.js 用 CDN 的 ES module 載入(importmap),版本號寫死,不要用打包工具
- 用 GLTFLoader 的 loadAsync 載入[radio.glb],算出模型大小,自動縮放到固定尺寸,放在畫面中間偏右
- 3D 畫布固定在畫面上,文字區塊在它上面捲
- 加上環境貼圖和一盞方向光,讓材質看得出來
先只做到「模型出現在頁面上」,捲動的效果下一步再加。
main.js 的第 18 到 21 行:new GLTFLoader()、loader.loadAsync(MODEL)、scene.add(gltf.scene)
載入模型其實就這三行(我實際跑的 main.js)。
載入模型的關鍵幾行(可以直接對照)
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';

const loader = new GLTFLoader();
const gltf = await loader.loadAsync(MODEL);   // MODEL = 你的 .glb 路徑
scene.add(gltf.scene);
  1. 不要直接點兩下 index.html 開啟:瀏覽器不讓本機檔案載入 ES module。請 Claude 幫你開一個本機伺服器(例如 npx serve),再用 localhost 的網址開。
  2. 模型太大、太小或偏掉都很正常。請它用 Box3 量出模型的大小,自動縮放、置中。
  3. 模型看起來一片黑,通常是沒有光。請它加上 RoomEnvironment 當環境貼圖,再補一盞方向光。

05最後:把鏡頭綁到捲動

做法很單純:算出現在捲到整頁的幾分之幾(0 到 1),把它換成一個角度,鏡頭就在一個圓上繞著模型走。模型本身不動,動的是鏡頭。

請 Claude 加上捲動(把[]換成你要的)
現在加上捲動效果:
- 算出捲動進度 p(0 到 1)
- 鏡頭繞著模型走一個圓,捲到底剛好[一圈],同時慢慢升高一點
- 鏡頭永遠看著模型的中心
- 用 scroll 事件加 requestAnimationFrame 更新畫面,不要用 setInterval
main.js 的 frame 函式:用 scrollY 算出 p,再用 Math.sin 和 Math.cos 決定鏡頭的位置
鏡頭綁捲動的那一段(我實際跑的 main.js)。
鏡頭綁捲動的程式(可以直接對照)
const RADIUS = 4.4;
const page = document.documentElement;
function frame() {
  const max = page.scrollHeight - innerHeight;
  const p = max > 0 ? scrollY / max : 0;   // 捲動進度 0 到 1
  const a = 0.5 + p * Math.PI * 2;         // 捲到底剛好一圈
  camera.position.x = Math.sin(a) * RADIUS;
  camera.position.z = Math.cos(a) * RADIUS;
  camera.position.y = 0.5 + p * 0.9;       // 慢慢升高
  camera.lookAt(0, 0, 0);
  renderer.render(scene, camera);
}
addEventListener('scroll', () => requestAnimationFrame(frame), { passive: true });

06要注意

  1. Claude 不是完全做不出 3D:方塊、球、用程式拼出來的簡單形狀,它寫得出來。做不出來的是從照片變成有細節、有貼圖的模型,這一段才需要 Hunyuan3D 這類工具。
  2. 授權有地區限制:Hunyuan3D 2.1 的授權不適用於歐盟、英國、南韓。人在這些地方,或要給這些地方的客戶用,改看 MIT 授權的 TRELLIS.2。
  3. 免費線上版跑在 Hugging Face 的共用 GPU(ZeroGPU)上,可能要排隊,也可能有用量限制;我這次沒有實測。
  4. GLB 檔可能很大:我用的範例模型就有 10.6 MB。放上正式網站之前,請 Claude 幫你壓縮貼圖或簡化模型,不然手機載入會很慢。
  5. three.js 會改版,import 的路徑可能跟著變。我用的是 0.160.0;請 Claude 把版本號寫死。
  6. 示範頁的收音機是 Khronos 的範例模型,品牌 BOOMBOX 88 是虛構的;影片裡「照片變模型」那一幕是示意,不是 Hunyuan3D 的實際輸出。

資料來源

延伸閱讀