# Meshy 3D API via PiAPI

> Meshy 3D API gives developers asynchronous image-to-3D and text-to-3D generation with GLB output.

Landing page: https://piapi.ai/meshy-3d-api
Base URL: https://api.piapi.ai
Authentication: use the API key from your PiAPI workspace.
Documentation: https://piapi.ai/docs/meshy-api/create-task

## Product details
- Category: 3d
- Vendor: meshy

## Runtime targets

### Meshy / Image to 3D
POST https://api.piapi.ai/api/v1/task
```json
{
  "model": "meshy",
  "task_type": "image-to-3d",
  "input": {
    "image_url": "YOUR_IMAGE_URL",
    "should_texture": true,
    "texture_resolution": "2k"
  }
}
```
GET https://api.piapi.ai/api/v1/task/{task_id}
Output fields: model_file
Workspace: https://piapi.ai/workspace/meshy?version=meshy-3d-api&operation=img2_3d
Documentation: https://piapi.ai/docs/meshy-api/create-task
- default: USD 0.36 / generation
- mesh-only: USD 0.24 / generation
- 2k: USD 0.36 / generation
- 4k: USD 0.36 / generation
- 8k: USD 0.42 / generation

### Meshy / Text to 3D
POST https://api.piapi.ai/api/v1/task
```json
{
  "model": "meshy",
  "task_type": "text-to-3d",
  "input": {
    "mode": "preview",
    "prompt": "A ceramic teapot",
    "texture_resolution": "2k"
  }
}
```
GET https://api.piapi.ai/api/v1/task/{task_id}
Output fields: model_file
Workspace: https://piapi.ai/workspace/meshy?version=meshy-3d-api&operation=txt2_3d
Documentation: https://piapi.ai/docs/meshy-api/create-task
- preview: USD 0.24 / generation
- refine: USD 0.12 / generation
- refine-2k: USD 0.12 / generation
- refine-4k: USD 0.12 / generation
- refine-8k: USD 0.18 / generation

### Facts
- Image-to-3D: Send an image URL and choose mesh-only or textured output at 2K, 4K, or 8K resolution.
- Preview-to-refine: Create a text-to-3D preview, wait for completion, then refine the completed task into a textured GLB.
- GLB output: Completed tasks return a PiAPI storage URL in output.model_file.

### Related entities
- Meshy 3D API
- Meshy
- PiAPI

## FAQ
### What does the Meshy 3D API return?

Completed image-to-3D and text-to-3D tasks return a GLB URL at output.model_file.

### How does text-to-3D preview and refine work?

Create a preview with mode=preview, wait for it to complete, then send its completed PiAPI task_id as preview_task_id with mode=refine.

### How is Meshy priced?

Image-to-3D is priced by mesh or texture resolution. Text-to-3D charges separately for preview and refine; the Playground shows the selected estimate.