Meshy 7.1 Text to 3D API

meshy/v7.1/text-to-3d

Meshy 7.1 Text to 3D turns a written object description into a textured 3D model with up to 4K geometry, quad or triangle topology and PBR maps. Start with a geometry preview or go straight to the textured model, then add rigging and an animation preset for humanoid characters.

Input

PromptRequired

135 / 600 characters

ModeOptional

Model TypeOptional

Geometry ResolutionOptional

TopologyOptional

Target PolycountOptional

Should RemeshOptional

Symmetry ModeOptional

Advanced settings

SeedOptional

Enable Prompt ExpansionOptional

Enable PbrOptional

Texture PromptOptional

Texture Image UrlOptional

Pose ModeOptional

Enable RiggingOptional

Rigging Height MetersOptional

Enable AnimationOptional

Animation Action IdOptional

Enable Safety CheckerOptional

Output

Meshy 7.1 Text to 3D model ready

Loading 3D preview…

Continue using

Meshy 7.1 Image to 3D Meshy 7.1 Multi Image to 3D Meshy 6 Text to 3D

Meshy 7.1 Text to 3D API

Quick Start

Submit Meshy 7.1 Text to 3D inputs, retain task_id, and query the task for the returned files.

Authenticate for Meshy 7.1 Text to 3D

Send your Vidgo API key in the Bearer authorization header.

Endpoint: POSThttps://api.vidgo.ai/api/generate/submit
Authentication: Authorization: Bearer YOUR_API_KEY

Submit a Meshy 7.1 Text to 3D request

Place model at the request root and the prompt value inside input.

Request example

REQUEST_BODY=$(cat <<'JSON'
{
  "model": "meshy/v7.1/text-to-3d",
  "input": {
    "prompt": "A vintage brass diving helmet with three round porthole windows, riveted seams, a leather neck collar and a small air valve on the side",
    "mode": "full",
    "model_type": "standard",
    "geometry_resolution": "4k",
    "topology": "triangle",
    "target_polycount": 30000,
    "should_remesh": true,
    "symmetry_mode": "auto",
    "enable_pbr": true
  }
}
JSON
)

RESPONSE=$(curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://api.vidgo.ai/api/generate/submit" \
  --header "Authorization: Bearer $VIDGO_API_KEY" \
  --header "Content-Type: application/json" \
  --data "$REQUEST_BODY")

CODE=$(printf '%s' "$RESPONSE" | jq -r '.code // empty')
if [ "$CODE" != "0" ] && [ "$CODE" != "200" ]; then
  printf 'API error: %s
' "$RESPONSE" >&2
  exit 1
fi
printf '%s
' "$RESPONSE"

Check the Meshy 7.1 Text to 3D task

Query the returned task_id until status is finished or failed.

Status endpoint

GET https://api.vidgo.ai/api/generate/status/{task_id}

When status is finished, inspect files and download the returned assets.

not_startedrunningfinishedfailed

Submission response

{
  "code": 200,
  "data": {
    "task_id": "P3B7BJMQ44EBHPR5",
    "status": "not_started",
    "created_time": "2026-11-05T07:07:06"
  }
}

Completed response

{
  "code": 200,
  "data": {
    "task_id": "P3B7BJMQ44EBHPR5",
    "status": "finished",
    "files": [
      {
        "file_url": "https://cdn.vidgo.ai/apis/models/meshy/v7.1/text-to-3d/v2/01/model-01.glb",
        "file_type": "3d",
        "label": "model_glb",
        "format": "glb",
        "file_name": "model-01.glb"
      },
      {
        "file_url": "https://cdn.vidgo.ai/apis/models/meshy/v7.1/text-to-3d/v2/01/model-01.fbx",
        "file_type": "3d",
        "label": "model_fbx",
        "format": "fbx",
        "file_name": "model-01.fbx"
      },
      {
        "file_url": "https://cdn.vidgo.ai/apis/models/meshy/v7.1/text-to-3d/v2/01/model-01.obj",
        "file_type": "3d",
        "label": "model_obj",
        "format": "obj",
        "file_name": "model-01.obj"
      },
      {
        "file_url": "https://cdn.vidgo.ai/apis/models/meshy/v7.1/text-to-3d/v2/01/model-01.stl",
        "file_type": "3d",
        "label": "model_stl",
        "format": "stl",
        "file_name": "model-01.stl"
      },
      {
        "file_url": "https://cdn.vidgo.ai/apis/models/meshy/v7.1/text-to-3d/v2/01/model-01.usdz",
        "file_type": "3d",
        "label": "model_usdz",
        "format": "usdz",
        "file_name": "model-01.usdz"
      },
      {
        "file_url": "https://cdn.vidgo.ai/apis/models/meshy/v7.1/text-to-3d/v2/01/thumbnail-01.png",
        "file_type": "image",
        "label": "thumbnail",
        "format": "png",
        "file_name": "thumbnail-01.png"
      }
    ],
    "created_time": "2026-11-05T07:07:06",
    "error_message": null,
    "progress": 100
  }
}

Read Meshy 7.1 Text to 3D files

Read each returned files item for file_url, file_type, label, and format.

Read Meshy 7.1 Text to 3D files

set -euo pipefail
: "${VIDGO_API_KEY:?Set VIDGO_API_KEY in your environment}"

REQUEST_BODY=$(cat <<'JSON'
{
  "model": "meshy/v7.1/text-to-3d",
  "input": {
    "prompt": "A vintage brass diving helmet with three round porthole windows, riveted seams, a leather neck collar and a small air valve on the side",
    "mode": "full",
    "model_type": "standard",
    "geometry_resolution": "4k",
    "topology": "triangle",
    "target_polycount": 30000,
    "should_remesh": true,
    "symmetry_mode": "auto",
    "enable_pbr": true
  }
}
JSON
)

SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://api.vidgo.ai/api/generate/submit" \
  --header "Authorization: Bearer $VIDGO_API_KEY" \
  --header "Content-Type: application/json" \
  --data "$REQUEST_BODY")

TASK_ID=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.data.task_id // .task_id // empty')
BUSINESS_CODE=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.code // empty')
if [ "$BUSINESS_CODE" != "0" ] && [ "$BUSINESS_CODE" != "200" ]; then
  printf 'Submit failed:
%s
' "$SUBMIT_RESPONSE" >&2
  exit 1
fi
if [ -z "$TASK_ID" ]; then
  printf 'Submit response did not include task_id:
%s
' "$SUBMIT_RESPONSE" >&2
  exit 1
fi

START_TIME=$(date +%s)
POLL_DELAY=2
while true; do
  if [ $(( $(date +%s) - START_TIME )) -ge 600 ]; then
    printf 'Timed out after 600 seconds
' >&2
    exit 1
  fi
  STATUS_RESPONSE=$(curl --silent --show-error --fail-with-body \
    --url "https://api.vidgo.ai/api/generate/status/$TASK_ID" \
    --header "Authorization: Bearer $VIDGO_API_KEY")
  STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.data.status // .status // empty')
  BUSINESS_CODE=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.code // empty')
  if [ "$BUSINESS_CODE" != "0" ] && [ "$BUSINESS_CODE" != "200" ]; then
    printf 'Status request failed:
%s
' "$STATUS_RESPONSE" >&2
    exit 1
  fi

  case "$STATUS" in
    finished)
      printf '%s' "$STATUS_RESPONSE" | jq -r '(.data.files // .files // [])[]?.file_url'
      break
      ;;
    failed)
      printf '%s' "$STATUS_RESPONSE" | jq -r '.data.error_message // .error_message // "Generation failed"' >&2
      exit 1
      ;;
    not_started|running)
      sleep "$POLL_DELAY"
      if [ "$POLL_DELAY" -lt 10 ]; then POLL_DELAY=$((POLL_DELAY + 1)); fi
      ;;
    *)
      printf 'Unexpected task status: %s
' "$STATUS" >&2
      exit 1
      ;;
  esac
done

Input Parameters

Place model and optional callback_url at the request root; put the fields listed below inside input.

Field	Type	Required	Default	Description
model	string	Yes	—	meshy/v7.1/text-to-3d
input	object	Yes	—	Generation settings for this endpoint.
input.prompt	string	Yes	—	Describe one object, its main parts, shape and materials in 1–600 characters.
input.mode	string	No	full	preview builds geometry only (160 credits); full adds textures (240 credits). Default full.
input.model_type	string	No	standard	standard keeps the regular mesh; smart-topology builds a cleaner, lighter mesh with a 100–15,000 polygon target. Default standard.
input.geometry_resolution	string	No	—	Geometry detail: standard, 2k, 4k. Available with model_type standard. Leave unset for the default.
input.topology	string	No	triangle	triangle or quad faces. Default triangle.
input.target_polycount	integer	No	30000	Target polygon count: 100–300,000 (default 30,000), or 100–15,000 (default 4,000) with smart-topology.
input.should_remesh	boolean	No	true	true remeshes to the chosen topology and polygon target; false keeps the raw triangle mesh. Default true.
input.symmetry_mode	string	No	auto	off, auto or on. Default auto.
input.seed	integer	No	—	Optional integer to repeat a generation setup.
input.enable_prompt_expansion	boolean	No	false	true lets the model add detail to a short prompt. Default false.
input.enable_pbr	boolean	No	false	Adds metallic, roughness and normal maps to the base color.
input.texture_prompt	string	No	—	Up to 600 characters describing colors, patterns and materials.
input.texture_image_url	string	No	—	A public image URL used as a texture reference.
input.pose_mode	string	No	""	a-pose or t-pose for characters, or empty for no pose. Default empty.
input.enable_rigging	boolean	No	false	Adds a humanoid skeleton (+40 credits). Default false.
input.rigging_height_meters	number	No	1.7	Character height in meters for rigging, greater than 0. Default 1.7.
input.enable_animation	boolean	No	false	Applies an animation preset (+24 credits). Requires enable_rigging true.
input.animation_action_id	integer	No	92	Animation preset ID from 0 to 696. Default 92.
input.enable_safety_checker	boolean	No	true	Runs the upstream safety checker. Default true.
callback_url	string	No	—	Provide a public HTTP(S) URL for completed or failed task notifications.

Response Fields

The status response reports task state, progress, and returned files.

Field	Type	Description
code	integer	API response code.
data.task_id	string	Task ID for status queries.
data.status	string	Task state: not_started, running, finished, or failed.
data.progress	integer	Reported generation progress from 0 to 100.
data.files	array	Generated model, preview image, and companion files.
data.files[].file_url	string	URL for a returned file.
data.files[].file_type	string	File category: 3d, image or other.
data.files[].label	string	File role, such as model_glb or thumbnail.
data.files[].format	string	File format, such as glb or png.
data.files[].file_name	string	File name when provided.
data.files[].file_size	integer	File size in bytes when provided.
data.error_message	string \| null	Error details for a failed task.

Task Lifecycle

Use task_id to check the same generation until it finishes or fails.

not_started
The task has been accepted and awaits generation.
running
The 3D model is being generated; continue querying this task.
finished
Generation is complete; read files for the assets.
failed
The task failed; read error_message before submitting another request.

Polling and Errors

Keep the task IDIf a status query is interrupted, use the same task_id to retrieve the latest state.
Download returned assetsUse file_url and file_name from each returned file to download the model and companion assets.
Review a failed generationWhen status is failed, read error_message, then review the input before submitting a new task.

Endpoint Specifications

Item	Value	Description
Input	Prompt, 1–600 characters	Describe one object, its parts and materials.
Geometry resolution	standard, 2k, 4k	Requires model_type standard.
Topology	triangle, quad	Target polycount 100–300,000; 100–15,000 with Smart Topology.
Output files	GLB, FBX, OBJ, USDZ, STL	Formats returned depend on the task; read files for the full list.
Price	$1.200 default	160 credits geometry + 80 texture; +40 rigging, +24 animation.

View the Meshy 7.1 Text to 3D API docs

Meshy 7.1 Text to 3D

Meshy 7.1 Text to 3D is a Meshy model that builds a 3D asset from a prompt of up to 600 characters. Meshy designed the 7.1 generation around richer geometric detail, and you choose that detail with standard, 2k or 4k geometry resolution or a lighter Smart Topology mesh. Texture guidance, PBR maps, A-pose or T-pose characters, rigging and animation presets carry the result into game, AR and previs work.

Why choose Meshy 7.1 Text to 3D?

Start from words aloneDescribe the object, its parts and materials in up to 600 characters; no reference image is needed.
Preview geometry before paying for texturesmode preview returns geometry for 160 credits, so you can check the shape before a 240-credit textured run.
Choose the level of geometric detailSelect standard, 2k or 4k geometry resolution, or Smart Topology for a lighter, cleaner mesh.
Ready characters for animationPose a humanoid in A-pose or T-pose, add a skeleton and apply an animation preset by ID from 0 to 696.

Parameters

Parameter	Requirement	What it controls
prompt	Required	Describe one object, its main parts, shape and materials in 1–600 characters.
mode	Optional	preview builds geometry only (160 credits); full adds textures (240 credits). Default full. Default`fullpreview`
model_type	Optional	standard keeps the regular mesh; smart-topology builds a cleaner, lighter mesh with a 100–15,000 polygon target. Default standard. Default`standardsmart-topology`
geometry_resolution	Optional	Geometry detail: standard, 2k, 4k. Available with model_type standard. Leave unset for the default. `standard2k4k`
topology	Optional	triangle or quad faces. Default triangle. Default`trianglequad`
target_polycount	Optional	Target polygon count: 100–300,000 (default 30,000), or 100–15,000 (default 4,000) with smart-topology. Default`30000`
should_remesh	Optional	true remeshes to the chosen topology and polygon target; false keeps the raw triangle mesh. Default true. Default`true`
symmetry_mode	Optional	off, auto or on. Default auto. Default`autooffon`
seed	Optional	Optional integer to repeat a generation setup.
enable_prompt_expansion	Optional	true lets the model add detail to a short prompt. Default false. Default`false`
enable_pbr	Optional	Adds metallic, roughness and normal maps to the base color. Default`false`
texture_prompt	Optional	Up to 600 characters describing colors, patterns and materials.
texture_image_url	Optional	A public image URL used as a texture reference.
pose_mode	Optional	a-pose or t-pose for characters, or empty for no pose. Default empty. Default`""a-poset-pose`
enable_rigging	Optional	Adds a humanoid skeleton (+40 credits). Default false. Default`false`
rigging_height_meters	Optional	Character height in meters for rigging, greater than 0. Default 1.7. Default`1.7`
enable_animation	Optional	Applies an animation preset (+24 credits). Requires enable_rigging true. Default`false`
animation_action_id	Optional	Animation preset ID from 0 to 696. Default 92. Default`92`
enable_safety_checker	Optional	Runs the upstream safety checker. Default true. Default`true`

How to Use

Describe the objectWrite a Prompt naming the object, its main parts, shape and materials.
Pick mode and detailChoose preview or full, then Model Type and, for standard meshes, Geometry Resolution.
Shape the meshSet Topology, Target Polycount and Symmetry Mode; open Advanced settings for textures, pose and rigging.
Run and inspectCheck the cost on Run, select Run, then rotate the GLB preview and download the files you need.

Pricing by option

Meshy 7.1 Text to 3D is billed per generation from four parts: 160 credits for geometry, 80 for textures (mode full), 40 for rigging and 24 for animation. A request with default settings is textured and costs 240 credits ($1.200). Geometry resolution, model type, topology and polygon count do not change the price.

Generation	Cost	Billing unit
Textured (mode full, default)	$1.200 · 240 credits	160 base + 80 texture
Geometry only (mode preview)	$0.800 · 160 credits	160 base
Add rigging	+$0.200 · +40 credits	enable_rigging true
Add animation	+$0.120 · +24 credits	enable_animation true, with rigging
Textured, rigged and animated	$1.520 · 304 credits	160 + 80 + 40 + 24

Use Cases

Game propsGenerate crates, tools and set dressing with quad topology and a polygon target for your engine.
Character base meshesDescribe a character, pose it in A-pose and rig it for previs and blocking.
Concept explorationRun several geometry previews to compare silhouettes before texturing the favorite.
3D print draftsExport STL when it is returned and review scale and wall thickness in your slicer.

Pro Tips

Name the object first, then list its parts and materials: "a brass diving helmet with three porthole windows and riveted seams".
Use mode preview to compare shapes, then switch to full for the version you keep.
Geometry Resolution needs Model Type standard; for Smart Topology keep Target Polycount between 100 and 15,000.
For characters, describe a neutral stance and set pose_mode a-pose or t-pose before enabling rigging.

Notes

Read every item in files: GLB is typically returned, with FBX, OBJ, USDZ or STL, textures and a thumbnail when available. Rigged and animated files are added when requested.
Rigging is designed for humanoid characters with clear limbs. Review the skeleton and weights in your 3D tool before production use.

Meshy 7.1 Text to 3D related models

Meshy 7.1 Image to 3DCreate a 3D model from one image.

Meshy 7.1 Multi Image to 3DRebuild a 3D model from 1–4 views.

Meshy 6 Text to 3DThe previous Meshy generation at a lower price per model.

Meshy 7.1 Text to 3D API frequently asked questions

What is the Meshy 7.1 Text to 3D API?

Meshy 7.1 Text to 3D is a Meshy model for generating 3D assets from text descriptions. It turns a prompt into a textured model with up to 4K geometry, triangle or quad topology, PBR maps and optional rigging and animation. Built on Meshy's detail-focused 7.1 generation, it follows the parts and materials you describe while letting you set polygon targets and symmetry. You can call it programmatically or try it from the playground above.

When should I use preview mode in Meshy 7.1 Text to 3D?

Use mode preview to get geometry only for 160 credits while you iterate on the prompt. Switch to full (240 credits, the default) for the textured model you plan to keep.

Does Meshy 7.1 Text to 3D support 4K geometry?

Yes. Set geometry_resolution to 4k with model_type standard. The option controls mesh detail, not the size of texture images; standard and 2k give lighter results.

How does prompt expansion work in Meshy 7.1 Text to 3D?

Set enable_prompt_expansion to true and the model adds detail to a short prompt before generating. Keep it off when you want the description followed as written, and add a seed to repeat a setup.

How much does Meshy 7.1 Text to 3D cost?

A default request is textured and costs 240 credits ($1.200). Geometry only costs 160 credits ($0.800); rigging adds 40 ($0.200) and animation adds 24 ($0.120). Resolution, topology and polygon count do not change the price.

How does Meshy 7.1 Text to 3D rig and animate characters?

Set enable_rigging to true to add a humanoid skeleton, with rigging_height_meters for the character's height (default 1.7). Then set enable_animation to true and pick animation_action_id from 0 to 696 (default 92). A-pose or T-pose input helps the rig.

Which files does Meshy 7.1 Text to 3D return?

Finished tasks list their files in files: typically a GLB, plus FBX, OBJ, USDZ or STL when available, texture maps and a thumbnail. Rigged and animated files are added when you request them.

How is Meshy 7.1 Text to 3D different from Meshy 6 Text to 3D?

Meshy 7.1 Text to 3D belongs to Meshy's newer, detail-focused generation, with up to 4K geometry resolution, Smart Topology and animation presets numbered 0–696. Meshy 6 Text to 3D costs 60 credits ($0.300) per generation on Vidgo and suits quick drafts; Meshy 7.1 Text to 3D costs 160–304 credits depending on options.