meshy-ai

✓Verified·Scanned 2/18/2026

Use the Meshy.ai REST API to generate assets: (1) text-to-2d (Meshy Text to Image) and (2) image-to-3d, then download outputs locally. Use when the user wants Meshy generations, needs polling async tasks, and especially when they want the resulting OBJ saved to disk. Requires MESHY_API_KEY in the environment.

from clawhub.ai·vcc58dfa·13.1 KB·0 installs
Scanned from 0.1.0 at cc58dfa · Transparency log ↗
$ vett add clawhub.ai/sabatesduran/meshy-ai

meshy-ai

Small Python helpers for the Meshy.ai REST API. The scripts create async tasks, poll until completion, and download outputs locally.

Features

  • Text-to-Image (2D) generation with optional multi-view output.
  • Image-to-3D generation with OBJ (and optional MTL) download.
  • Simple polling + download helpers in a shared client.

Requirements

  • Python 3.8+ (no third-party dependencies)
  • Meshy API key

Setup

Set the API key in your environment:

export MESHY_API_KEY=msy-...

Optional base URL override:

export MESHY_BASE_URL=https://api.meshy.ai

Usage

Text → Image

python3 scripts/text_to_image.py \
  --prompt "a cute robot mascot, flat vector style" \
  --out-dir ./meshy-out

Optional flags:

  • --ai-model (default: nano-banana)
  • --aspect-ratio (only when not using multi-view)
  • --generate-multi-view
  • --timeout (seconds; default 900)

Outputs are saved to:

./meshy-out/text-to-image_<taskId>_<slug>/image_1.png

Image → 3D (OBJ)

Local file:

python3 scripts/image_to_3d_obj.py \
  --image ./input.png \
  --out-dir ./meshy-out

Public URL:

python3 scripts/image_to_3d_obj.py \
  --image-url "https://example.com/input.png" \
  --out-dir ./meshy-out

Optional flags:

  • --ai-model (default: latest)
  • --model-type (standard | lowpoly)
  • --topology (triangle | quad)
  • --target-polycount (int)
  • --should-texture / --no-texture
  • --timeout (seconds; default 1800)

Outputs are saved to:

./meshy-out/image-to-3d_<taskId>_<slug>/model.obj
./meshy-out/image-to-3d_<taskId>_<slug>/model.mtl   # if provided

Notes