infery
← All models

V7 Image to 3D

v7

3D generationby Meshy

Turns a single image into a fully textured, PBR-ready 3D mesh with complete geometry, in game-ready Smart Topology at a target polygon count

Details

Accepts
text + image

Pricing

Price
100 cr / request

Prices in credits (1 credit = $0.01).

Data schema

Input

FieldTypeDescription
topologystringenum: quad, triangleSpecify the topology of the generated model. Quad for smooth surfaces, Triangle for detailed geometry.
image_urlstringImage 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.
pose_modestringenum: a-pose, t-pose, Pose mode for the generated model. 'a-pose' generates an A-pose, 't-pose' generates a T-pose, empty string for no specific pose.
enable_pbrbooleanGenerate PBR Maps (metallic, roughness, normal) in addition to base color
model_typestringenum: standardType of 3D mesh generation. Only 'standard' is supported; Smart Topology has its own endpoints (/t2.5 and /t2).
ultra_modebooleanDeprecated: use geometry_resolution='2k'. If both fields are provided, geometry_resolution takes precedence.
is_a_t_posebooleanDeprecated: use pose_mode instead. When true, generates a T-pose model.
should_remeshbooleanWhether to enable the remesh phase
symmetry_modestringenum: off, auto, onControls symmetry behavior during model generation. Off disables symmetry, Auto determines it automatically, On enforces symmetry.
texture_model—Model that textures the generated mesh, in the same task. Leave unset to use the endpoint model's default texture model. Ignored when should_texture is false. meshy-n1 makes a 2K base color texture from reference images only: it rejects texture_prompt, enable_pbr, and quad topology with remeshing. W…
enable_riggingbooleanAutomatically rig the generated model as a humanoid character. Includes basic walking and running animations. Best results with humanoid characters that have clearly defined limbs.
should_texturebooleanWhether to generate textures
texture_prompt—Text prompt to guide the texturing process. Maximum 800 characters.
include_fingersbooleanRig the character's fingers. Works with any skeleton template. Only used when enable_rigging is true.
enable_animationbooleanApply an animation preset to the rigged model. Requires enable_rigging to be true.
target_polycountintegerTarget number of polygons in the generated model.
skeleton_template—Skeleton template for the rig. Animations made from the rig use the same skeleton. Leave unset for Meshy's default skeleton (meshyrig). Some models can only be rigged on meshyrig without fingers; those requests fail with a 422. Only used when enable_rigging is true.
texture_image_url—2D image to guide the texturing process
animation_action_idintegerAnimation preset ID from Meshy's library. Only used when enable_animation is true; in that case it must be in [0, 696] (``0`` is the "Idle" preset) and is otherwise rejected with a 422. See https://docs.meshy.ai/en/api/animation-library for available action IDs.
geometry_resolution—Geometry resolution. Meshy-7 supports standard and 2k.
enable_safety_checkerbooleanIf set to true, input data will be checked for safety before processing.
rigging_height_metersnumberApproximate height of the character in meters. Only used when enable_rigging is true.
modestringenum: preview, fullGeneration mode. 'preview' returns untextured geometry only, 'full' returns textured model (preview + refine).
seed—Seed for reproducible results. Same prompt and seed usually generate the same result.
promptstringDescribe what kind of object the 3D model is. Maximum 600 characters.
enable_prompt_expansionbooleanWhether to enable prompt expansion. This will use a large language model to expand the prompt with additional details while maintaining the original meaning.

Output

FieldTypeDescription
seed—The seed used for generation (if available)
model_glb—Generated 3D object in GLB format.
thumbnail—Preview thumbnail of the generated model
model_urls—URLs for different 3D model formats
rig_task_id—Rigging task ID. Only present when enable_rigging is true.
texture_urlsarrayArray of texture file objects, matching Meshy API structure
animation_fbx—Animated 3D model in FBX format. Only present when enable_animation is true.
animation_glb—Animated 3D model in GLB format. Only present when enable_animation is true.
basic_animations—Basic walking and running animations. Only present when enable_rigging is true.
rigged_character_fbx—Rigged character in FBX format. Only present when enable_rigging is true.
rigged_character_glb—Rigged character in GLB format. Only present when enable_rigging is true.