Skip to main content
PiAPI
Workspace
PiAPI

Resources

CLIAPI DocsBilling
Credits$—
Theme

3d models

Meshy 3D API / for image-to-3D and text-to-3D generation

Use through PiAPI to submit asynchronous 3D generation tasks and retrieve a completed GLB asset.

Commencer !

Meshy 3D API Pricing

Pay per successful generation through PiAPI.

Image to 3D mesh

$0.24

  • Mesh-only GLB output

Image to 3D textured

from $0.36

  • 2k — $0.36
  • 4k — $0.36
  • 8k — $0.42

Text preview → refine

from $0.24

  • Preview — $0.24
  • Refine 2K/4K — $0.12
  • Refine 8K — $0.18
Get StartedAPI docsFull pricing

Meshy 3D API Features

Image-to-3D generation

Send an image URL and choose mesh-only output or textured output at 2K, 4K, or 8K texture resolution.

Text-to-3D preview

Start a text-to-3D preview task with a prompt, then use its completed PiAPI task_id for refinement.

Refine completed previews

The refine request accepts preview_task_id and returns a completed GLB model through the same task polling flow.

Asynchronous task API

Submit a task to PiAPI, poll its task status or use a webhook, and read the finished model from output.model_file.

Quick start

Create your API key

Sign up and grab an API key from the PiAPI workspace — free credits are included on sign-up.

Top up credits

Add credits on the billing page when you are ready to scale beyond the free tier.

Call the API

POST your first task following the API docs, then poll the task until the result is ready.

Iterate in the playground

Prototype prompts and settings in the the playground above before wiring them into your product.

Create a task

curl -X POST 'https://api.piapi.ai/api/v1/task' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "meshy",
  "task_type": "image-to-3d",
  "input": {
    "image_url": "YOUR_IMAGE_URL",
    "should_texture": true,
    "texture_resolution": "2k"
  }
}'

Retrieve the result

curl 'https://api.piapi.ai/api/v1/task/{task_id}' \
  -H 'X-API-Key: YOUR_API_KEY'

model_file

Pricing

  • default: $0.36 / generation
  • mesh-only: $0.24 / generation
  • 2k: $0.36 / generation
  • 4k: $0.36 / generation
  • 8k: $0.42 / generation
Get StartedAPI docs

Meshy 3D API FAQ

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

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

How are image-to-3D requests priced?

The estimate changes with should_texture and texture_resolution. The Workspace displays the selected estimate before submission.

Where can I find the request schema?

See the Meshy create-task and get-task API documentation linked from this page.

More questions? See the API docs.