AI 3D 模型 API — 从文本或图像生成 3D

什么是 AI 3D 模型 API？

AI 3D 模型 API 可以将文本描述、参考图或多个视角转换为带纹理的 3D 资产。它无需本地运行重建流程，就能通过 REST 将 3D 生成接入产品、游戏、设计和内容应用。

Muapi 将 Tripo3D 和 Meshy 放入同一套提交与轮询工作流。快速迭代可从 H3.1 性价比档位开始；几何形状更重要时使用多视角输入；生产输出则选择高级或游戏就绪模型。

核心能力

代表性 AI 3D 模型对比

价格和支持的输入因模型而异。请在各模型的 Playground Schema 中确认输出格式、拓扑选项和必填图像字段。

如何调用 AI 3D 模型 API

1. 选择文本、图像或多视角输入。 根据输入证据和所需资产质量选择 Tripo3D 或 Meshy 模型。
2. 必要时托管参考图。 通过 POST /api/v1/upload_file 上传源图，或提供所选 Schema 接受的公开可访问 URL。
3. 提交生成请求。 调用 POST /api/v1/{model-slug}，并传入提示词、图像字段，以及模型支持的拓扑、纹理或输出格式参数。
4. 轮询预测任务。 持续检查 GET /api/v1/predictions/{request_id}/result，直到异步任务完成。
5. 保存资产和元数据。 将返回的模型和纹理下载到自己的存储，并保存模型 slug 与请求元数据以便复现。

curl -X POST https://api.muapi.ai/api/v1/tripo3d-h31-text-to-3d \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "prompt": "a stylized red fox explorer with a backpack, game-ready 3D asset"
  }'

import requests

response = requests.post(
    "https://api.muapi.ai/api/v1/tripo3d-h31-text-to-3d",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={"prompt": "a stylized red fox explorer with a backpack, game-ready 3D asset"},
)
request_id = response.json()["request_id"]

result = requests.get(
    f"https://api.muapi.ai/api/v1/predictions/{request_id}/result",
    headers={"x-api-key": "YOUR_API_KEY"},
)
print(result.json())

常见问题