Output
3D mesh
Aspect ratio
1:1
Resolution
1024
Example prompt
A vibrant neon phoenix warrior with blazing gradient wings, crimson-gold molten armor, and a flaming swordTry this prompt →
LLM-ready
API & LLM schema
Exact request contract for this model. Agents can fetch it from /api/v1/models?id=fal-ai/meshy/v6/text-to-3d.
POST
/api/v1/generate25 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. |
mode | string | Optional | Generation mode. 'preview' returns untextured geometry only, 'full' returns textured model. · Allowed: preview, full · Default: full |
enable_rigging | boolean | Optional | Automatically rig the generated model as a humanoid character. Best results with humanoid characters. · Default: false |
seed | integer | Optional | Seed for reproducible results. |
pose_mode | string | Optional | Pose mode for the generated model. · Allowed: a-pose, t-pose, · Default: |
enable_pbr | boolean | Optional | Generate PBR maps (metallic, roughness, normal) in addition to base color. · Default: false |
rigging_height_meters | number | Optional | Approximate height of the character in meters. Only used when enable_rigging is true. · Default: 1.7 |
texture_prompt | string | Optional | Additional text prompt to guide the texturing process (only used in 'full' mode). |
should_remesh | boolean | Optional | Whether to enable the remesh phase. When false, returns unprocessed triangular mesh. · Default: true |
topology | string | Optional | Mesh topology. Quad for smooth surfaces, Triangle for detailed geometry. · Allowed: quad, triangle · Default: triangle |
enable_animation | boolean | Optional | Apply an animation preset to the rigged model. Requires enable_rigging to be true. · Default: false |
target_polycount | number | Optional | Target number of polygons in the generated model. · Default: 30000 · Range: 100–300000 |
symmetry_mode | string | Optional | Controls symmetry behavior during model generation. · 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–… |
enable_safety_checker | boolean | Optional | Run the input safety checker before processing. · Default: true |
texture_image_url | string | Optional | 2D image to guide the texturing process (only used in 'full' mode). |
enable_prompt_expansion | boolean | Optional | Use a large language model to expand the prompt with additional details while maintaining the original meaning. · Default: false |
aspect_ratio | string | Optional | Allowed: 1:1 |
resolution | string | Optional | Allowed: 1024 |
Minimal request example
{
"model_id": "fal-ai/meshy/v6/text-to-3d",
"prompt": "A vibrant neon phoenix warrior with blazing gradient wings, crimson-gold molten armor, and a flaming sword"
}Raw JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fmeshy%2Fv6%2Ftext-to-3d",
"title": "Meshy-6 Text → 3D generation request",
"description": "Request body accepted by POST /api/v1/generate for fal-ai/meshy/v6/text-to-3d.",
"type": "object",
"properties": {
"model_id": {
"type": "string",
"const": "fal-ai/meshy/v6/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"
},
"mode": {
"title": "Mode",
"description": "Generation mode. 'preview' returns untextured geometry only, 'full' returns textured model.",
"default": "full",
"type": "string",
"enum": [
"preview",
"full"
]
},
"enable_rigging": {
"title": "Enable Rigging",
"description": "Automatically rig the generated model as a humanoid character. Best results with humanoid characters.",
"default": false,
"type": "boolean"
},
"seed": {
"title": "Seed",
"description": "Seed for reproducible results.",
"type": "integer"
},
"pose_mode": {
"title": "Pose Mode",
"description": "Pose mode for the generated model.",
"default": "",
"type": "string",
"enum": [
"a-pose",
"t-pose",
""
]
},
"enable_pbr": {
"title": "Enable PBR",
"description": "Generate PBR maps (metallic, roughness, normal) in addition to base color.",
"default": false,
"type": "boolean"
},
"rigging_height_meters": {
"title": "Rigging Height (m)",
"description": "Approximate height of the character in meters. Only used when enable_rigging is true.",
"default": 1.7,
"type": "number"
},
"texture_prompt": {
"title": "Texture Prompt",
"description": "Additional text prompt to guide the texturing process (only used in 'full' mode).",
"type": "string"
},
"should_remesh": {
"title": "Remesh",
"description": "Whether to enable the remesh phase. When false, returns unprocessed triangular mesh.",
"default": true,
"type": "boolean"
},
"topology": {
"title": "Topology",
"description": "Mesh topology. Quad for smooth surfaces, Triangle for detailed geometry.",
"default": "triangle",
"type": "string",
"enum": [
"quad",
"triangle"
]
},
"enable_animation": {
"title": "Enable Animation",
"description": "Apply an animation preset to the rigged model. Requires enable_rigging to be true.",
"default": false,
"type": "boolean"
},
"target_polycount": {
"title": "Target Polycount",
"description": "Target number of polygons in the generated model.",
"default": 30000,
"type": "number",
"minimum": 100,
"maximum": 300000,
"multipleOf": 1
},
"symmetry_mode": {
"title": "Symmetry Mode",
"description": "Controls symmetry behavior during model generation.",
"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
},
"enable_safety_checker": {
"title": "Enable Safety Checker",
"description": "Run the input safety checker before processing.",
"default": true,
"type": "boolean"
},
"texture_image_url": {
"title": "Texture Guide Image",
"description": "2D image to guide the texturing process (only used in 'full' mode).",
"type": "string"
},
"enable_prompt_expansion": {
"title": "Prompt Expansion",
"description": "Use a large language model to expand the prompt with additional details while maintaining the original meaning.",
"default": false,
"type": "boolean"
},
"aspect_ratio": {
"type": "string",
"enum": [
"1:1"
]
},
"resolution": {
"type": "string",
"enum": [
"1024"
]
}
},
"required": [
"model_id",
"prompt"
],
"additionalProperties": false
}FAQ
How much does Meshy-6 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-6 Text → 3D fails?
Yes — failed generations are never charged. The credits are released back to your balance automatically.
Can I call Meshy-6 Text → 3D from the API?
Yes. Use POST /api/v1/generate with model_id: "fal-ai/meshy/v6/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-6 Text → 3D?
Start now →No commitment. New accounts get 50 free credits on signup. See pricing.