API docs / 3D models

Meshy 7.1 (Meshy 7.1 Text to 3D) API

Generate a textured GLB from a written description, with optional Ultra 2K or 4K geometry.

Model id
meshy/v7.1/text-to-3d
Provider
Meshy
Output
3D
Price
From 419 credits per run, the same as on voor.ai. Options such as length or resolution can change it.

Request

POST https://voor.ai/v1/generations with "model": "meshy/v7.1/text-to-3d". Poll GET /v1/tasks/{id} or receive the signed webhook. See the overview for keys, idempotency, webhooks and errors.

curl https://voor.ai/v1/generations \
  -H "Authorization: Bearer $VOOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "meshy/v7.1/text-to-3d",
  "input": {
    "prompt": "A red fox standing in fresh snow at golden hour, soft light"
  },
  "callback_url": "https://example.com/webhooks/voor"
}'

# Then poll the task (or wait for the webhook):
curl https://voor.ai/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $VOOR_API_KEY"

Input parameters

NameTypeDetails
promptrequiredstring

Describe one object: shape, materials, colours and the details that must be sculpted. Up to 600 characters.

Up to 600 characters

seednumber

Reuse a seed with the same prompt to get a closely matching model — useful for a preview then full pass.

enable_pbrboolean

Add metallic, roughness and normal maps to the base colour texture.

Default: false

geometry_resolutionstring

Ultra 2K and Ultra 4K sculpt finer surface detail (engravings, stitching, scales) into the mesh itself. Slower, same output format.

Default: standard

One of: standard, 2k, 4k

modestring

Full returns a textured model. Preview returns untextured geometry for fewer credits, to check the shape first.

Default: full

One of: full, preview

model_typestring

Standard is the detailed mesh. Low poly makes a clean game-style mesh. Smart topology builds cleanly separated parts.

Default: standard

One of: standard, lowpoly, smart-topology

symmetry_modestring

Auto decides per object; on forces a mirrored mesh; off keeps asymmetric details.

Default: auto

One of: auto, on, off

target_polycountnumber

Polygon budget after remeshing. Low poly ignores it; smart topology is capped at 15,000.

Default: 30000

Min 100 · Max 300000

texture_promptstring

Optional direction for the texturing pass only — paint finish, wear, colour changes.

Up to 600 characters

topologystring

Triangle keeps the most fine detail; quad gives smoother, easier-to-edit surfaces.

Default: triangle

One of: triangle, quad