Meshy 6 Image to 3D API

meshy/v6/image-to-3d

Meshy 6 Image to 3D turns a single object image into a 3D model with configurable topology, symmetry, and texture generation. Use the image as a shape reference, then adjust remeshing and material guidance for the generated asset.

Input

Image UrlsRequired

Drag and drop files, paste from clipboard, or provide a URL. Provide one publicly accessible HTTP(S) image URL showing the object.

1/1 files added

TopologyOptional

Target PolycountOptional

Should RemeshOptional

Symmetry ModeOptional

Should TextureOptional

Advanced settings

Enable PbrOptional

Pose ModeOptional

Texture PromptOptional

Texture Image UrlOptional

Enable RiggingOptional

Rigging Height MetersOptional

Enable AnimationOptional

Animation Action IdOptional

Enable Safety CheckerOptional

Output

Meshy 6 Image to 3D model ready

Loading 3D preview…

Continue using

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

Examples

Carved Walnut Humpback

Strawberry Cream Cake Slice

Meshy 6 Image to 3D API

Quick Start

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

Authenticate for Meshy 6 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 6 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/v6/image-to-3d",
  "input": {
    "image_urls": [
      "https://example.com/object-front.png"
    ],
    "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 6 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": "your_task_id",
    "status": "not_started",
    "created_time": "2026-09-27T10:00:00"
  }
}

Completed response

{
  "code": 200,
  "data": {
    "task_id": "your_task_id",
    "status": "finished",
    "files": [
      {
        "file_url": "https://example.com/model.glb",
        "file_type": "3d",
        "label": "model_glb",
        "format": "glb",
        "file_name": "model.glb"
      },
      {
        "file_url": "https://example.com/preview.png",
        "file_type": "image",
        "label": "thumbnail",
        "format": "png"
      }
    ],
    "progress": 100,
    "error_message": null
  }
}

Read Meshy 6 Image to 3D files

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

Read Meshy 6 Image to 3D files

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

REQUEST_BODY=$(cat <<'JSON'
{
  "model": "meshy/v6/image-to-3d",
  "input": {
    "image_urls": [
      "https://example.com/object-front.png"
    ],
    "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/v6/image-to-3d
input	object	Yes	—	Generation settings for this endpoint.
input.image_urls	array	Yes	—	Provide one publicly accessible HTTP(S) image URL showing the object.
input.topology	string	No	triangle	Choose triangle or quad mesh topology. Default: triangle.
input.target_polycount	integer	No	30000	Set the target polygon count as an integer. Default: 30000.
input.should_remesh	boolean	No	true	Enable remeshing to apply the chosen topology and polygon target. Default: true.
input.symmetry_mode	string	No	auto	Choose off, auto, or on for symmetry. Default: auto.
input.should_texture	boolean	No	true	Generate textures from the reference images. Default: true.
input.enable_pbr	boolean	No	—	Generate PBR material maps for metallic, roughness, and normal details.
input.pose_mode	string	No	""	Choose a-pose, t-pose, or an empty string for the model pose. Default: empty string.
input.texture_prompt	string	No	—	Describe colors, patterns, and materials to guide the texture.
input.texture_image_url	string	No	—	Provide a publicly accessible HTTP(S) image URL as a texture reference.
input.enable_rigging	boolean	No	—	Add a skeleton to a humanoid character for posing and animation.
input.rigging_height_meters	number	No	1.7	Set the character height in meters when rigging. Default: 1.7.
input.enable_animation	boolean	No	—	Apply an animation preset with enable_rigging set to true.
input.animation_action_id	integer	No	1001	Select an integer animation preset ID. Default: 1001.
input.enable_safety_checker	boolean	No	true	Enable input safety checking. 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	one reference image	Provide exactly one publicly accessible HTTP(S) image URL.
Topology	triangle, quad	Choose triangle or quad mesh topology. Default: triangle.
Output files	GLB, FBX, OBJ, USDZ, BLEND, STL	Read the files returned by the task for model formats, textures, and animation assets.

View the Meshy 6 Image to 3D API docs

Meshy 6 Image to 3D

Meshy 6 Image to 3D is a Meshy model that builds a 3D asset from one reference image. The image supplies the object reference while topology, target polygon count, symmetry, and remeshing configure the mesh. Texture generation, reference guidance, and optional PBR maps provide material controls; humanoid characters can also receive a skeleton and an animation preset.

Why Choose Meshy 6 Image to 3D?

Build from one object imageSupply a single view of an object and generate a model you can rotate and inspect.
Tune the mesh from the referenceChoose topology, target polygon count, symmetry, and remeshing for the generated geometry.
Choose how surfaces are madeUse should_texture with text or image texture guidance, and request PBR maps for material work.

Parameters

Parameter	Requirement	What it controls
image_urls	Required	Provide one publicly accessible HTTP(S) image URL showing the object.
topology	Optional	Choose triangle or quad mesh topology. Default: triangle. Default`trianglequad`
target_polycount	Optional	Set the target polygon count as an integer. Default: 30000. Default`30000`
should_remesh	Optional	Enable remeshing to apply the chosen topology and polygon target. Default: true. Default`true`
symmetry_mode	Optional	Choose off, auto, or on for symmetry. Default: auto. Default`autooffon`
should_texture	Optional	Generate textures from the reference images. Default: true. Default`true`
enable_pbr	Optional	Generate PBR material maps for metallic, roughness, and normal details.
pose_mode	Optional	Choose a-pose, t-pose, or an empty string for the model pose. Default: empty string. Default`""a-poset-pose`
texture_prompt	Optional	Describe colors, patterns, and materials to guide the texture.
texture_image_url	Optional	Provide a publicly accessible HTTP(S) image URL as a texture reference.
enable_rigging	Optional	Add a skeleton to a humanoid character for posing and animation.
rigging_height_meters	Optional	Set the character height in meters when rigging. Default: 1.7. Default`1.7`
enable_animation	Optional	Apply an animation preset with enable_rigging set to true.
animation_action_id	Optional	Select an integer animation preset ID. Default: 1001. Default`1001`
enable_safety_checker	Optional	Enable input safety checking. Default: true. Default`true`

How to Use

Choose one reference imageUpload one object image or enter its publicly accessible URL in Image Urls.
Set geometry controlsChoose Topology and Target Polycount, then adjust remeshing or symmetry if needed.
Set texture optionsUse Should Texture for texture generation; add Texture Prompt, Texture Image Url, or Enable Pbr for material guidance.
Generate and inspectReview the 60-credit cost and select Run. Rotate the returned GLB model and download the available files.

Pricing

Meshy 6 Image to 3D costs $0.300, or 60 credits, for each generation.

Generation	Cost	Billing unit
Meshy 6 Image to 3D	$0.300 / generation · 60 credits	One submitted generation

Use Cases

Single-view product conceptsTurn one product reference into a 3D model for reviewing the object from different angles.
Illustrated prop modelingUse a clear illustration of a prop to establish its shape before refining mesh and surface settings.
Humanoid image studiesUse one character image with pose, rigging, and animation controls for humanoid asset exploration.

Pro Tips

Choose an image with the full object visible and a clear silhouette.
Use should_texture=true to generate textures from the reference image.
Set triangle or quad topology and a target polygon count before remeshing.
For a humanoid character, enable rigging before choosing animation.

Notes

Inspect model and thumbnail files by label. Download returned texture, skeleton, and animation assets when those options are used.

Meshy 6 Image to 3D Related Models

Meshy 6 Text to 3DMeshy 6 Text to 3D creates a 3D model from an object description.

Meshy 6 Multi Image to 3DMeshy 6 Multi Image to 3D uses 1–4 views of the same object to generate a 3D model.

Meshy 6 Image to 3D API frequently asked questions

What is the Meshy 6 Image to 3D API?

Meshy 6 Image to 3D is a Meshy model for creating a 3D asset from one reference image. It uses the object image with topology, remeshing, symmetry, and texture controls to generate a model. Texture generation and PBR options guide material work, while pose, rigging, and animation settings support humanoid assets. You can submit a request through the API or try the model in the Playground on this page.

What image works best for Meshy 6 Image to 3D?

Provide exactly one publicly accessible image showing the object with a clear outline and visible main parts. That single image is the shape reference for this endpoint.

How does Meshy 6 Image to 3D create textures?

Set should_texture to true to generate textures from the image; true is the default. Use texture_prompt or texture_image_url to add surface guidance.

Which topology can Meshy 6 Image to 3D generate?

Choose triangle or quad topology and set an integer target_polycount. The should_remesh setting applies the mesh controls, while symmetry_mode sets off, auto, or on.

Can Meshy 6 Image to 3D use a material reference?

Provide texture_image_url as a publicly accessible image URL, or use texture_prompt to describe the intended colors and surface patterns. Both fields are available for texture guidance.

What PBR maps can Meshy 6 Image to 3D request?

Set enable_pbr to true to request metallic, roughness, and normal maps for the generated material.

How does Meshy 6 Image to 3D prepare a humanoid pose?

Choose a-pose or t-pose with pose_mode, then enable_rigging for a skeleton. Set enable_animation to true with rigging enabled to apply an animation preset.

When should I choose Meshy 6 Image to 3D over Multi Image to 3D?

Choose Image to 3D when one reference image describes the object. Choose Meshy 6 Multi Image to 3D when you have one to four images of the same object from different angles.