Meshy 7.1 Image to 3D API

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

Meshy 7.1 Image to 3D turns a single photo or concept image into a textured 3D model with up to 4K geometry, Smart Topology and PBR maps. It follows the silhouette and surface details of your image while letting you set topology, polygon count, pose and rigging.

Input

Image UrlsRequired

Drag and drop files, paste from clipboard, or provide a URL. Upload one clear JPG or PNG of the object, or give a public HTTP(S) URL.

1/1 files added

Should TextureOptional

Model TypeOptional

Geometry ResolutionOptional

TopologyOptional

Target PolycountOptional

Should RemeshOptional

Symmetry ModeOptional

Advanced settings

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 Image to 3D model ready

Loading 3D preview…

Continue using

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

Meshy 7.1 Image to 3D API

Quick Start

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

Authenticate for Meshy 7.1 Image 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 Image to 3D request

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

Request example

REQUEST_BODY=$(cat <<'JSON'
{
  "model": "meshy/v7.1/image-to-3d",
  "input": {
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/meshy/v7.1/image-to-3d/v1/01/input-1.png"
    ],
    "model_type": "standard",
    "geometry_resolution": "4k",
    "should_texture": true,
    "enable_pbr": true,
    "topology": "triangle",
    "target_polycount": 30000,
    "should_remesh": true,
    "symmetry_mode": "auto"
  }
}
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 Image 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": "12GKNDTSJZ15XDP0",
    "status": "not_started",
    "created_time": "2026-11-05T07:07:24"
  }
}

Completed response

{
  "code": 200,
  "data": {
    "task_id": "12GKNDTSJZ15XDP0",
    "status": "finished",
    "files": [
      {
        "file_url": "https://cdn.vidgo.ai/apis/models/meshy/v7.1/image-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/image-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/image-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/image-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/image-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/image-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:24",
    "error_message": null,
    "progress": 100
  }
}

Read Meshy 7.1 Image to 3D files

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

Read Meshy 7.1 Image to 3D files

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

REQUEST_BODY=$(cat <<'JSON'
{
  "model": "meshy/v7.1/image-to-3d",
  "input": {
    "image_urls": [
      "https://cdn.vidgo.ai/apis/models/meshy/v7.1/image-to-3d/v1/01/input-1.png"
    ],
    "model_type": "standard",
    "geometry_resolution": "4k",
    "should_texture": true,
    "enable_pbr": true,
    "topology": "triangle",
    "target_polycount": 30000,
    "should_remesh": true,
    "symmetry_mode": "auto"
  }
}
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/image-to-3d
input	object	Yes	—	Generation settings for this endpoint.
input.image_urls	string[]	Yes	—	Upload one clear JPG or PNG of the object, or give a public HTTP(S) URL.
input.should_texture	boolean	No	true	true textures the model (+80 credits); false returns geometry only. Default true.
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.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	1 image	JPG or PNG URL, or an uploaded file.
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 Image to 3D API docs

Meshy 7.1 Image to 3D

Meshy 7.1 Image to 3D is a Meshy model that reconstructs a 3D asset from one reference image. Meshy built the 7.1 generation for finer geometric detail and describes an Ultra 4K geometry option, which you select with geometry_resolution 4k. The model returns GLB and other formats with textures, and adds PBR maps, Smart Topology, pose control and rigging when you need production-friendly assets.

Why choose Meshy 7.1 Image to 3D?

One image is enoughUpload a product photo or concept sketch and receive a textured 3D model.
Up to 4K geometryUse geometry_resolution 4k for dense surface detail, or standard and 2k for lighter assets.
Smart Topology for enginesmodel_type smart-topology targets 100–15,000 polygons with a cleaner mesh for real-time use.
Characters from concept artSet T-pose or A-pose and enable rigging to turn character art into a rigged model.

Parameters

Parameter	Requirement	What it controls
image_urls	Required	Upload one clear JPG or PNG of the object, or give a public HTTP(S) URL.
should_texture	Optional	true textures the model (+80 credits); false returns geometry only. Default true. Default`true`
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`
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

Add the imageUpload one clear image of the object or paste a public URL.
Choose texture and detailKeep Should Texture on for a textured model, and pick Model Type and Geometry Resolution.
Set mesh and character optionsAdjust Topology and Target Polycount; in Advanced settings add PBR, pose or 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 Image to 3D is billed per generation from four parts: 160 credits for geometry, 80 for textures (should_texture true), 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 (should_texture true, default)	$1.200 · 240 credits	160 base + 80 texture
Geometry only (should_texture false)	$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

E-commerce ARTurn a product photo into GLB or USDZ for web and mobile AR viewers.
Concept art to modelConvert a character or prop drawing into a mesh for review.
Detailed collectiblesUse 4K geometry for figurines and ornaments with fine surface relief.
Real-time assetsUse Smart Topology for lighter models in games and interactive scenes.

Pro Tips

Use a sharp, well-lit image with one centered object and a plain background.
Show the whole object without cropping; hidden parts are inferred from what is visible.
Choose 4k geometry for fine relief and standard or Smart Topology for lighter real-time assets.
Add a Texture Prompt to refine colors and materials without changing the input image.

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 Image to 3D related models

Meshy 7.1 Text to 3DCreate a 3D model from a written description.

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

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

Meshy 7.1 Image to 3D API frequently asked questions

What is the Meshy 7.1 Image to 3D API?

Meshy 7.1 Image to 3D is a Meshy model for generating 3D assets from a single image. It turns one photo or concept image into a textured model with up to 4K geometry, Smart Topology, PBR maps and optional rigging. Built on Meshy's detail-focused 7.1 generation, it preserves the silhouette and surface details of the image while you control topology and polygon count. You can call it programmatically or try it from the playground above.

Which images work best for Meshy 7.1 Image to 3D?

Use a sharp, evenly lit JPG or PNG with one centered object, little occlusion and a simple background. The model infers hidden sides from the visible ones, so a three-quarter view often helps.

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

Yes. Set geometry_resolution to 4k with model_type standard for the densest surface detail. It controls mesh detail rather than texture image size.

What does Smart Topology change in Meshy 7.1 Image to 3D?

model_type smart-topology produces a cleaner, lighter mesh with a target of 100–15,000 polygons (default 4,000). Geometry Resolution is used with the standard model type.

How much does Meshy 7.1 Image 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 Image 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 Image 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 Image to 3D different from Meshy 6 Image to 3D?

Meshy 7.1 Image 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 Image to 3D costs 60 credits ($0.300) per generation on Vidgo and suits quick drafts; Meshy 7.1 Image to 3D costs 160–304 credits depending on options.