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 服务器 →