Output
3D mesh
Example prompt
A weathered clockwork fox explorer with a brass compass, leather satchel, expressive eyes, and production-ready materialsTry this prompt →
LLM-ready
API & LLM schema
Exact request contract for this model. Agents can fetch it from /api/v1/models?id=meshy/v7/text-to-3d.
POST
/api/v1/generate26 fields · 2 required| Field | Type | Requirement | Contract |
|---|---|---|---|
model_id | constant | Required | ArtEmotion model identifier. |
extra | object | Optional | Model-specific settings may also be nested here. |
max_credits | number | Optional | Reject before submission if the estimated list price exceeds this cap. · Range: 1–… |
webhook_url | string | Optional | Format: uri |
webhook_secret | string | Optional | Optional model input. |
folder_id | string | Optional | Optional model input. |
prompt | string | Required | Optional model input. |
symmetry_mode | string | Optional | Allowed: off, auto, on · Default: auto |
animation_action_id | integer | Optional | Select an available motion from Meshy's live library. For generation models, enable Add Animation to apply it. · Default: 92 · Range: 0–… |
topology | string | Optional | Allowed: quad, triangle · Default: triangle |
enable_animation | boolean | Optional | Default: false |
is_a_t_pose | boolean | Optional | Default: false |
enable_prompt_expansion | boolean | Optional | Default: false |
texture_image_url | string | Optional | Optional model input. |
ultra_mode | boolean | Optional | Default: false |
pose_mode | string | Optional | Allowed: , a-pose, t-pose · Default: |
texture_prompt | string | Optional | Optional texture guidance, up to 600 characters. |
model_type | string | Optional | Allowed: standard, lowpoly, smart-topology · Default: standard |
mode | string | Optional | Allowed: preview, full · Default: full |
enable_safety_checker | boolean | Optional | Default: true |
should_remesh | boolean | Optional | Default: true |
enable_pbr | boolean | Optional | Default: false |
target_polycount | integer | Optional | Default: 30000 · Range: 100–300000 |
seed | integer | Optional | Optional model input. |
enable_rigging | boolean | Optional | Default: false |
rigging_height_meters | number | Optional | Default: 1.7 · Range: 0.1–… |
Minimal request example
{
"model_id": "meshy/v7/text-to-3d",
"prompt": "A weathered clockwork fox explorer with a brass compass, leather satchel, expressive eyes, and production-ready materials"
}Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=meshy%2Fv7%2Ftext-to-3d",
"title": "Meshy 7 Text → 3D generation request",
"description": "Request body accepted by POST /api/v1/generate for meshy/v7/text-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "meshy/v7/text-to-3d",
"description": "ArtEmotion model identifier."
},
"extra": {
"type": "object",
"additionalProperties": true,
"description": "Model-specific settings may also be nested here."
},
"max_credits": {
"type": "number",
"minimum": 1,
"description": "Reject before submission if the estimated list price exceeds this cap."
},
"webhook_url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"webhook_secret": {
"type": "string",
"maxLength": 512
},
"folder_id": {
"type": "string"
},
"prompt": {
"type": "string",
"maxLength": 600
},
"symmetry_mode": {
"title": "Symmetry",
"default": "auto",
"type": "string",
"enum": [
"off",
"auto",
"on"
]
},
"animation_action_id": {
"title": "Animation",
"description": "Select an available motion from Meshy's live library. For generation models, enable Add Animation to apply it.",
"default": 92,
"type": "integer",
"minimum": 0,
"multipleOf": 1
},
"topology": {
"title": "Topology",
"default": "triangle",
"type": "string",
"enum": [
"quad",
"triangle"
]
},
"enable_animation": {
"title": "Add Animation",
"default": false,
"type": "boolean"
},
"is_a_t_pose": {
"title": "Force T-Pose",
"default": false,
"type": "boolean"
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"default": false,
"type": "boolean"
},
"texture_image_url": {
"title": "Texture Guide",
"type": "string"
},
"ultra_mode": {
"title": "Ultra Detail",
"default": false,
"type": "boolean"
},
"pose_mode": {
"title": "Pose",
"default": "",
"type": "string",
"enum": [
"",
"a-pose",
"t-pose"
]
},
"texture_prompt": {
"title": "Texture Prompt",
"description": "Optional texture guidance, up to 600 characters.",
"type": "string",
"maxLength": 600
},
"model_type": {
"title": "Model Type",
"default": "standard",
"type": "string",
"enum": [
"standard",
"lowpoly",
"smart-topology"
]
},
"mode": {
"title": "Mode",
"default": "full",
"type": "string",
"enum": [
"preview",
"full"
]
},
"enable_safety_checker": {
"title": "Safety Checker",
"default": true,
"type": "boolean"
},
"should_remesh": {
"title": "Remesh",
"default": true,
"type": "boolean"
},
"enable_pbr": {
"title": "PBR Materials",
"default": false,
"type": "boolean"
},
"target_polycount": {
"title": "Target Polycount",
"default": 30000,
"type": "integer",
"minimum": 100,
"maximum": 300000,
"multipleOf": 1
},
"seed": {
"title": "Seed",
"type": "integer"
},
"enable_rigging": {
"title": "Rig Character",
"default": false,
"type": "boolean"
},
"rigging_height_meters": {
"title": "Rigging Height",
"default": 1.7,
"type": "number",
"minimum": 0.1,
"multipleOf": 0.1
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}FAQ
How much does Meshy 7 Text → 3D cost on ArtEmotion?
Credit-based pricing. You pay in ArtEmotion credits — every plan and top-up converts USD to credits at a fixed rate.
Do I get my credits back if Meshy 7 Text → 3D fails?
Yes — failed generations are never charged. The credits are released back to your balance automatically.
Can I call Meshy 7 Text → 3D from the API?
Yes. Use POST /api/v1/generate with model_id: "meshy/v7/text-to-3d". See the API reference for the full schema.
Where are my generations stored?
Every output is saved to your personal Library. You can export or delete everything any time from Privacy & deletion.
Ready to generate with Meshy 7 Text → 3D?
Start now →No commitment. New accounts get 50 free credits on signup. See pricing.