Meshy modelsimage generation api

meshy/meshy-v6

Name: Meshy 6
Author: Meshy

Meshy V6 by Meshy - convert 2D images into 3D models with AI. Generate textured 3D assets from single photos for games, AR/VR, e-commerce, and digital content creation.

Input

Image URL or upload(string)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum

Image URL or base64 data URI for 3D model creation. Supports .jpg, .jpeg, and .png formats. Also supports AVIF and HEIF formats which will be automatically converted.

This field is required.

Topology(string)

Specify the topology of the generated model. Quad for smooth surfaces, Triangle for detailed geometry. Allowed values: quad, triangle.

Enable Rigging(boolean)

Automatically rig the generated model as a humanoid character. Includes basic walking and running animations. Best results with humanoid characters that have clearly defined limbs.

Texture Prompt(string)

Text prompt to guide the texturing process

Enable Pbr(boolean)

Generate PBR Maps (metallic, roughness, normal) in addition to base color

Animation Action Id(integer)

Animation preset ID from Meshy's library (500+ presets). Only used when enable_animation is true. See https://docs.meshy.ai/en/api/animation-library for available action IDs.

Rigging Height Meters(number)

Approximate height of the character in meters. Only used when enable_rigging is true.

Should Texture(boolean)

Whether to generate textures

Pose Mode(string)

Pose mode for the generated model. 'a-pose' generates an A-pose, 't-pose' generates a T-pose, empty string for no specific pose. Allowed values: a-pose, t-pose, .

Should Remesh(boolean)

Whether to enable the remesh phase

Is A T Pose(boolean)

Deprecated: use pose_mode instead. When true, generates a T-pose model.

Target Polycount(integer)

100300000

Target number of polygons in the generated model Range: 100 to 300000.

Image URL or upload(string)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum

2D image to guide the texturing process

Enable Animation(boolean)

Apply an animation preset to the rigged model. Requires enable_rigging to be true.

Symmetry Mode(string)

Controls symmetry behavior during model generation. Off disables symmetry, Auto determines it automatically, On enforces symmetry. Allowed values: off, auto, on.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDmeshy/meshy-v6

Input Schema

15 parameters · 1 required · 14 optional

Parameter	Type	Required	Description
`image`	string	Required	Image URL or base64 data URI for 3D model creation. Supports .jpg, .jpeg, and .png formats. Also supports AVIF and HEIF formats which will be automatically converted.
`topology`	string	Optional	Specify the topology of the generated model. Quad for smooth surfaces, Triangle for detailed geometry. · Options: quad, triangle · Default: "triangle" quadtriangle
`pose_mode`	string	Optional	Pose mode for the generated model. 'a-pose' generates an A-pose, 't-pose' generates a T-pose, empty string for no specific pose. · Options: a-pose, t-pose, · Default: "" a-poset-pose
`enable_pbr`	boolean	Optional	Generate PBR Maps (metallic, roughness, normal) in addition to base color · Default: false
`is_a_t_pose`	boolean	Optional	Deprecated: use pose_mode instead. When true, generates a T-pose model. · Default: false
`should_remesh`	boolean	Optional	Whether to enable the remesh phase · Default: true
`symmetry_mode`	string	Optional	Controls symmetry behavior during model generation. Off disables symmetry, Auto determines it automatically, On enforces symmetry. · Options: off, auto, on · Default: "auto" offautoon
`enable_rigging`	boolean	Optional	Automatically rig the generated model as a humanoid character. Includes basic walking and running animations. Best results with humanoid characters that have clearly defined limbs. · Default: false
`should_texture`	boolean	Optional	Whether to generate textures · Default: true
`texture_prompt`	string	Optional	Text prompt to guide the texturing process · Max length: 600
`enable_animation`	boolean	Optional	Apply an animation preset to the rigged model. Requires enable_rigging to be true. · Default: false
`target_polycount`	integer	Optional	Target number of polygons in the generated model · Min: 100 · Max: 300000 · Default: 30000
`texture_image_url`	string	Optional	2D image to guide the texturing process
`animation_action_id`	integer	Optional	Animation preset ID from Meshy's library (500+ presets). Only used when enable_animation is true. See https://docs.meshy.ai/en/api/animation-library for available action IDs. · Default: 1001
`rigging_height_meters`	number	Optional	Approximate height of the character in meters. Only used when enable_rigging is true. · Default: 1.7

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "meshy/meshy-v6",
  "image": "https://static.sandbase.ai/examples/meshy/meshy-v6/input_image_0.png",
  "topology": "triangle",
  "pose_mode": "",
  "enable_pbr": false,
  "is_a_t_pose": false,
  "should_remesh": true,
  "symmetry_mode": "auto",
  "enable_rigging": false,
  "should_texture": true,
  "enable_animation": false,
  "target_polycount": 30000,
  "animation_action_id": 1001,
  "rigging_height_meters": 1.7,
  "prompt": "a beautiful sunset over mountains"
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Meshy 6

API README

Meshy 6

Meshy 6 is a Meshy route built for generative media creation. It turns a focused creative brief and the route-specific inputs into a production-ready media result, giving creators a focused endpoint instead of forcing one generic workflow across materially different production tasks. The route belongs to a family known for production-oriented 3D creation, editable assets, and fast iteration, so it is best evaluated as a creative system for intentional shots and assets rather than as a one-click novelty generator.

Use this endpoint when the input contract and deliverable match that job exactly. Its documented controls include topology choices (quad, triangle); pose_mode choices (a-pose, t-pose, ); enable_pbr (Generate PBR Maps (metallic, roughness, normal) in addition to base color); is_a_t_pose (Deprecated: use pose_mode instead. When true, generates a T-pose model). Together, these controls help teams plan predictable iterations, compare outputs under stable settings, and connect generation to game, product, visualization, and spatial-content pipelines without hiding the operational choices that shape the result.

Highlights

Meshy 6: dedicated route-specific generation. This exact route centers on route-specific generation; it uses image to separate its job from neighboring endpoints in the same family.
image control. Image URL or base64 data URI for 3D model creation. Supports .jpg, .jpeg, and .png formats. Also supports AVIF and HEIF formats which will be automatically converted; this setting provides a concrete lever for route-specific output planning.
topology control. options quad, triangle; use it to build controlled comparisons without changing the rest of the request.
pose_mode control. options a-pose, t-pose, ``; together with the other documented fields, it supports repeatable review of this model path.

Pricing

Configuration	Price
Standard request	`$0.800000`

When to Use

Scenario	Why this model fits
Create the exact route output	Choose it when you need generative media creation and already have a focused creative brief and the route-specific inputs.
Develop controlled variations	Keep the main brief fixed while changing one documented setting at a time to compare motion, framing, quality, or asset behavior.
Build repeatable batches	Use a consistent request shape for catalog, campaign, storyboard, game-asset, or social-content production.
Preserve source intent	Prefer this route when the supplied reference material must remain the foundation of a production-ready media result.
Connect a media pipeline	Use asynchronous results in an automated review, approval, post-production, or asset-management workflow.

Prompt Guide

Start with the desired result, then describe the source relationship, subject action, composition or camera behavior, lighting, style, and timing. For generative media creation, state what must remain stable as clearly as what should change. Use only fields exposed by the schema; the example below is structurally valid for this route.

{
  "image": "https://static.sandbase.ai/examples/meshy/meshy-v6/input_image_0.png",
  "topology": "triangle",
  "pose_mode": "",
  "enable_pbr": false,
  "is_a_t_pose": false
}

Technical Specs

Specification	Value
Model ID	`meshy/meshy-v6`
Workflow	Generative media creation
Required inputs	`image`
`image`	`string`
`topology`	`string`; options: `quad`, `triangle`
`pose_mode`	`string`; options: `a-pose`, `t-pose`, ``
`enable_pbr`	`boolean`
`is_a_t_pose`	`boolean`
`should_remesh`	`boolean`
`symmetry_mode`	`string`; options: `off`, `auto`, `on`
`enable_rigging`	`boolean`
`should_texture`	`boolean`
`texture_prompt`	`string`