Thrixel API

適用於應用程式與工作流程的 3D 生成

透過 Thrixel API 從文字或影像生成模型、細化個別零件並匯出資產。

開始使用 API 文件 →
建立模型 
THRIXEL_API_KEY='sk-thrixel-...'

curl --fail-with-body \
  https://api.thrixel.com/api/v1/architect/submit \
  -H "Authorization: Bearer $THRIXEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"task":"一座有梯子的木製瞭望塔"}'
POST /api/v1/architect/submit

API 功能

生成

Architect 建立具有可編輯零件的結構化模型。Sculptor 產生角色與生物等有機形態。

細化

透過文字編輯、新增幾何細節與紋理、減少三角面數量，或為角色綁定骨架。

匯出

下載 GLB、FBX、OBJ、STL 或 USDZ，用於遊戲引擎、網頁體驗與 3D 工作流程。

運作方式

  1. 驗證身分

    在 Thrixel 工作區的 Profile > API Keys 中建立 API 金鑰。從伺服器或指令碼以 Bearer 權杖形式傳遞金鑰。

  2. 追蹤工作

    每次提交都會傳回一個 ID。輪詢狀態或串流接收進度直到完成；下載前須處理失敗的工作。

  3. 下載結果

    使用已完成提交的 ID 下載模型或開始下一次細化。

GET /api/v1/{submission_id}/info
GET /api/v1/{submission_id}/download?format=glb

用量與存取

操作會消耗 Thrixel Cubes。帳戶用量資訊提供餘額與同時執行的工作上限；目前操作價格與方案限制請參閱文件。

API 文件 →

適用於程式設計代理的 Thrixel

MCP 伺服器將代理連接至這些功能，並處理工作進度與本機下載。

探索 MCP 伺服器 →