How it works
- 1POST to create a 3D generation task — pay $0.12–$1.20 USDC on Base, Solana, or Tempo
- 2Poll the task via GET until
status: "SUCCEEDED" - 3Download your 3D model (GLB, FBX, OBJ, STL, USDZ)
Example
Create task
POST /api/text-to-3d
{
"mode": "preview",
"prompt": "a medieval castle on a hill",
"ai_model": "meshy-6"
}Response
{
"result": "task_abc123"
}Poll until complete (SIWX auth)
GET /api/text-to-3d/task_abc123
{
"id": "task_abc123",
"status": "SUCCEEDED",
"progress": 100,
"model_urls": {
"glb": "https://assets.meshy.ai/...",
"fbx": "https://assets.meshy.ai/...",
"usdz": "https://assets.meshy.ai/..."
}
}Endpoints
| Endpoint | Price | Auth |
|---|---|---|
POST /api/text-to-3dGenerate 3D model from text (preview or refine) | $0.20–$0.80 | x402 / MPP |
GET /api/text-to-3d/{id}Retrieve task status and model URLs | Free | SIWX |
POST /api/image-to-3dGenerate 3D model from a single image | $0.20–$1.20 | x402 / MPP |
GET /api/image-to-3d/{id}Retrieve task status and model URLs | Free | SIWX |
POST /api/multi-image-to-3dGenerate 3D model from 1–4 images | $0.20–$1.20 | x402 / MPP |
GET /api/multi-image-to-3d/{id}Retrieve task status and model URLs | Free | SIWX |
POST /api/retextureApply new textures to existing 3D model | $0.40 | x402 / MPP |
POST /api/remeshRe-topology and format conversion | $0.20 | x402 / MPP |
POST /api/riggingAuto-rig a humanoid character | $0.20 | x402 / MPP |
POST /api/animationAnimate a rigged character | $0.12 | x402 / MPP |
Output formats
3D models are returned as download URLs in GLB, FBX, OBJ, STL, and USDZ formats. PBR textures (base color, metallic, normal, roughness) are available when enabled.
Discovery
OpenAPI spec at /openapi.json
Agent instructions at /llms.txt