Skip to main content
ArtEmotion
3D

Meshy Auto Split

Credit-based pricing.

Meshy Auto Split preview
Output
3D mesh
LLM-ready

API & LLM schema

Exact request contract for this model. Agents can fetch it from /api/v1/models?id=meshy/auto-split.

POST/api/v1/generate15 fields · 2 required
FieldTypeRequirementContract
model_idconstantRequiredArtEmotion model identifier.
extraobjectOptionalModel-specific settings may also be nested here.
max_creditsnumberOptionalReject before submission if the estimated list price exceeds this cap. · Range: 1–…
webhook_urlstringOptionalFormat: uri
webhook_secretstringOptionalOptional model input.
folder_idstringOptionalOptional model input.
promptstringOptionalOptional model input.
input_task_idstringRequiredCompleted Meshy 6/7/7.1 image, multi-image, text preview, remesh or conversion task.
split_modestringOptionalAllowed: auto, by_parts, by_color · Default: auto
layoutstringOptionalAllowed: assembled, on_plate · Default: assembled
target_formatsarray<string>OptionalJSON array: glb, obj, fbx, stl, usdz, blend, 3mf. GLB is always included. STL merges parts; choose 3MF for individually selectable print parts. · Default: glb,3mf · Items: 0–7
connectorsbooleanOptionalDefault: false
connector_typestringOptionalAllowed: cube, cylinder · Default: cube
connector_sizenumberOptionalDefault: 0.5 · Range: 0.1–0.8
connector_heightnumberOptionalDefault: 0.1 · Range: 0.1–0.8
Minimal request example
{
  "model_id": "meshy/auto-split",
  "input_task_id": "your_input_task_id"
}
Raw JSON Schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=meshy%2Fauto-split",
  "title": "Meshy Auto Split generation request",
  "description": "Request body accepted by POST /api/v1/generate for meshy/auto-split.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "meshy/auto-split",
      "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"
    },
    "input_task_id": {
      "title": "Source Meshy Model",
      "description": "Completed Meshy 6/7/7.1 image, multi-image, text preview, remesh or conversion task.",
      "type": "string"
    },
    "split_mode": {
      "title": "Split Mode",
      "default": "auto",
      "type": "string",
      "enum": [
        "auto",
        "by_parts",
        "by_color"
      ]
    },
    "layout": {
      "title": "Layout",
      "default": "assembled",
      "type": "string",
      "enum": [
        "assembled",
        "on_plate"
      ]
    },
    "target_formats": {
      "title": "Export Formats",
      "description": "JSON array: glb, obj, fbx, stl, usdz, blend, 3mf. GLB is always included. STL merges parts; choose 3MF for individually selectable print parts.",
      "default": [
        "glb",
        "3mf"
      ],
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 7
    },
    "connectors": {
      "title": "Add Connectors",
      "default": false,
      "type": "boolean"
    },
    "connector_type": {
      "title": "Connector Shape",
      "default": "cube",
      "type": "string",
      "enum": [
        "cube",
        "cylinder"
      ]
    },
    "connector_size": {
      "title": "Connector Size",
      "default": 0.5,
      "type": "number",
      "minimum": 0.1,
      "maximum": 0.8,
      "multipleOf": 0.1
    },
    "connector_height": {
      "title": "Connector Height",
      "default": 0.1,
      "type": "number",
      "minimum": 0.1,
      "maximum": 0.8,
      "multipleOf": 0.1
    }
  },
  "required": [
    "model_id",
    "input_task_id"
  ],
  "additionalProperties": false
}

FAQ

How much does Meshy Auto Split 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 Auto Split fails?

Yes — failed generations are never charged. The credits are released back to your balance automatically.

Can I call Meshy Auto Split from the API?

Yes. Use POST /api/v1/generate with model_id: "meshy/auto-split". 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 Auto Split?

Start now →

No commitment. New accounts get 50 free credits on signup. See pricing.