## Basic model info - Model name: meshy/meshy meshy-v6 - Model description: Meshy-6 is the latest model from Meshy. It generates realistic and production ready 3D models. - Endpoint name: text-to-3d ## Model schema The model schema is defined in the OpenAPI schema: [OpenAPI Schema](https://oapi.sunra.ai/main/meshy/meshy-v6/latest.json) ### Model input schema The model input schema is: ```json { "description": "Input schema for Meshy V6 text-to-3D generation.", "properties": { "prompt": { "description": "Describe what kind of object the 3D model is. Maximum 600 characters.", "maxLength": 600, "title": "Prompt", "type": "string", "x-sr-order": 301 }, "seed": { "description": "Seed for reproducible results. Same prompt and seed usually generate the same result.", "title": "Seed", "type": "integer", "x-sr-order": 304 }, "animation_action_id": { "default": 1001, "description": "Animation preset ID from Meshy's library. Only used when enable_animation is true.", "title": "Animation Action Id", "type": "integer", "x-sr-order": 504 }, "art_style": { "default": "realistic", "description": "Desired art style of the object. Note: enable_pbr should be false for sculpture style.", "enum": [ "realistic", "sculpture" ], "title": "Art Style", "type": "string", "x-sr-order": 303 }, "enable_animation": { "default": false, "description": "Apply an animation preset to the rigged model. Requires enable_rigging to be true.", "title": "Enable Animation", "type": "boolean", "x-sr-order": 503 }, "enable_pbr": { "default": false, "description": "Generate PBR Maps (metallic, roughness, normal) in addition to base color. Should be false for sculpture style.", "title": "Enable Pbr", "type": "boolean", "x-sr-order": 405 }, "enable_prompt_expansion": { "default": false, "description": "Whether to enable prompt expansion using a large language model.", "title": "Enable Prompt Expansion", "type": "boolean", "x-sr-order": 407 }, "enable_rigging": { "default": false, "description": "Automatically rig the generated model as a humanoid character.", "title": "Enable Rigging", "type": "boolean", "x-sr-order": 501 }, "enable_safety_checker": { "default": true, "description": "If set to true, input data will be checked for safety before processing.", "title": "Enable Safety Checker", "type": "boolean", "x-sr-order": 601 }, "mode": { "default": "full", "description": "Generation mode. 'preview' returns untextured geometry only, 'full' returns textured model.", "enum": [ "preview", "full" ], "title": "Mode", "type": "string", "x-sr-order": 302 }, "pose_mode": { "default": "default", "description": "Pose mode for the generated model.", "enum": [ "default", "a-pose", "t-pose" ], "title": "Pose Mode", "type": "string", "x-sr-order": 406 }, "rigging_height_meters": { "default": 1.7, "description": "Approximate height of the character in meters. Only used when enable_rigging is true.", "title": "Rigging Height Meters", "type": "number", "x-sr-order": 502 }, "should_remesh": { "default": true, "description": "Whether to enable the remesh phase.", "title": "Should Remesh", "type": "boolean", "x-sr-order": 403 }, "symmetry_mode": { "default": "auto", "description": "Controls symmetry behavior during model generation.", "enum": [ "off", "auto", "on" ], "title": "Symmetry Mode", "type": "string", "x-sr-order": 404 }, "target_polycount": { "default": 30000, "description": "Target number of polygons in the generated model.", "maximum": 300000, "minimum": 100, "title": "Target Polycount", "type": "integer", "x-sr-order": 402 }, "texture_image": { "anyOf": [ { "format": "uri", "maxLength": 2083, "minLength": 1, "type": "string" }, { "type": "string" } ], "description": "2D image URL to guide the texturing process (only used in 'full' mode).", "title": "Texture Image", "x-sr-order": 409 }, "texture_prompt": { "description": "Additional text prompt to guide the texturing process (only used in 'full' mode).", "title": "Texture Prompt", "type": "string", "x-sr-order": 408 }, "topology": { "default": "triangle", "description": "Specify the topology of the generated model. Quad for smooth surfaces, Triangle for detailed geometry.", "enum": [ "quad", "triangle" ], "title": "Topology", "type": "string", "x-sr-order": 401 } }, "required": [ "prompt" ], "title": "TextTo3DInput", "type": "object" } ``` ### Model output schema The model output schema is: ```json { "properties": { "model": { "properties": { "content_type": { "description": "The mime type of the file.", "title": "Content Type", "type": "string" }, "file_name": { "description": "The name of the file. It will be auto-generated if not provided.", "title": "File Name", "type": "string" }, "file_size": { "description": "The size of the file in bytes.", "title": "File Size", "type": "integer" }, "url": { "description": "The URL where the file can be downloaded from.", "title": "Url", "type": "string" } }, "required": [ "content_type", "file_name", "file_size", "url" ], "title": "SunraFile", "type": "object" } }, "required": [ "model" ], "title": "ModelOutput", "type": "object" } ``` ## Example inputs and outputs Use the following example inputs and outputs to understand the model. ### Input example ```json { "prompt": "", "seed": null, "animation_action_id": 1001, "art_style": "realistic", "enable_animation": false, "enable_pbr": false, "enable_prompt_expansion": false, "enable_rigging": false, "enable_safety_checker": true, "mode": "full", "pose_mode": "default", "rigging_height_meters": 1.7, "should_remesh": true, "symmetry_mode": "auto", "target_polycount": 30000, "texture_image": "", "texture_prompt": "", "topology": "triangle" } ``` ### Output example ```json { } ``` ## Model code examples ### JavaScript ```javascript import { sunra } from "@sunra/client"; const result = await sunra.subscribe("meshy/meshy-v6/text-to-3d", { input: { prompt: '', mode: 'full', art_style: 'realistic', seed: null, topology: 'triangle', target_polycount: 30000, should_remesh: true, symmetry_mode: 'auto', enable_pbr: false, pose_mode: 'default', enable_prompt_expansion: false, texture_prompt: '', texture_image: '', enable_rigging: false, rigging_height_meters: 1.7, enable_animation: false, animation_action_id: 1001, enable_safety_checker: true }, logs: true, onQueueUpdate: (update) => { console.log(`Status Update: ${update.status}, Request ID: ${update.request_id}`); }, }); console.log(result.data); console.log(result.requestId); ``` ### Python ```python import sunra_client result = sunra_client.subscribe( "meshy/meshy-v6/text-to-3d", arguments={ "prompt": "", "mode": "full", "art_style": "realistic", "seed": None, "topology": "triangle", "target_polycount": 30000, "should_remesh": True, "symmetry_mode": "auto", "enable_pbr": False, "pose_mode": "default", "enable_prompt_expansion": False, "texture_prompt": "", "texture_image": "", "enable_rigging": False, "rigging_height_meters": 1.7, "enable_animation": False, "animation_action_id": 1001, "enable_safety_checker": True }, with_logs=True, on_enqueue=print, on_queue_update=print, ) print(result) ``` ### Java ```java import ai.sunra.client.*; import java.util.Map; import com.google.gson.JsonObject; var client = SunraClient.withEnvCredentials(); var response = client.subscribe( "meshy/meshy-v6/text-to-3d", SubscribeOptions.builder() .input(Map.of( "prompt", "", "mode", "full", "art_style", "realistic", "seed", null, "topology", "triangle", "target_polycount", 30000, "should_remesh", true, "symmetry_mode", "auto", "enable_pbr", false, "pose_mode", "default", "enable_prompt_expansion", false, "texture_prompt", "", "texture_image", "", "enable_rigging", false, "rigging_height_meters", 1.7, "enable_animation", false, "animation_action_id", 1001, "enable_safety_checker", true)) .resultType(JsonObject.class) .onQueueUpdate(update -> System.out.printf( "\nStatus Update: %s, Request ID: %s%n", update.getStatus(), update.getRequestId() )) .logs(true) .build() ); System.out.println("Completed!"); System.out.println(response.getData()); ``` ### Kotlin ```kotlin import ai.sunra.client.kt.* import com.google.gson.JsonObject val client = createSunraClient() val response = client.subscribe( endpointId = "meshy/meshy-v6/text-to-3d", input = mapOf( "prompt" to "", "mode" to "full", "art_style" to "realistic", "seed" to null, "topology" to "triangle", "target_polycount" to 30000, "should_remesh" to true, "symmetry_mode" to "auto", "enable_pbr" to false, "pose_mode" to "default", "enable_prompt_expansion" to false, "texture_prompt" to "", "texture_image" to "", "enable_rigging" to false, "rigging_height_meters" to 1.7, "enable_animation" to false, "animation_action_id" to 1001, "enable_safety_checker" to true), options = ai.sunra.client.kt.SubscribeOptions(logs = true), onUpdate = { update -> println("\nStatus Update: ${update.status}, Request ID: ${update.requestId}") } ) println("Completed!") println(response.data) ``` ### Curl ```bash curl --request POST \ --url https://api.sunra.ai/v1/queue/meshy/meshy-v6/text-to-3d \ --header "Authorization: Key $SUNRA_KEY" \ --header "Content-Type: application/json" \ --data '{"prompt":"","mode":"full","art_style":"realistic","seed":null,"topology":"triangle","target_polycount":30000,"should_remesh":true,"symmetry_mode":"auto","enable_pbr":false,"pose_mode":"default","enable_prompt_expansion":false,"texture_prompt":"","texture_image":"","enable_rigging":false,"rigging_height_meters":1.7,"enable_animation":false,"animation_action_id":1001,"enable_safety_checker":true}' ``` ## Model readme >