Meshy Animation

Credit-based pricing.

Try Meshy Animation →Compare models

Output

3D mesh

LLM-ready

API & LLM schema

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

POST/api/v1/generate11 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.
`rig_task_id`	string	Required	Pick a completed Meshy Rigging generation to animate, or upload a 3D model instead.
`model_url`	string	Optional	Studio-only upload shortcut. Public v1 generation requires rig_task_id and ignores model_url.
`animation_action_id`	integer	Optional	Select an available motion from Meshy's live library. For generation models, enable Add Animation to apply it. · Default: 0 · Range: 0–…
`action_ids`	string / array<integer>	Optional	1–10 unique live preset IDs; overrides the single preset. Cannot be combined with motion_task_id.
`motion_task_id`	string	Optional	Optional completed Text to Motion clip, less than three days old. Requires a biped rig. Cannot be combined with Multiple Actions.

Minimal request example

{
  "model_id": "fal-ai/meshy/animation",
  "rig_task_id": "your_rig_task_id"
}

Raw JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fmeshy%2Fanimation",
  "title": "Meshy Animation generation request",
  "description": "Request body accepted by POST /api/v1/generate for fal-ai/meshy/animation.",
  "type": "object",
  "properties": {
    "model_id": {
      "type": "string",
      "const": "fal-ai/meshy/animation",
      "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"
    },
    "rig_task_id": {
      "title": "Rigged Model",
      "description": "Pick a completed Meshy Rigging generation to animate, or upload a 3D model instead.",
      "type": "string"
    },
    "model_url": {
      "type": "string",
      "description": "Studio-only upload shortcut. Public v1 generation requires rig_task_id and ignores model_url."
    },
    "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": 0,
      "type": "integer",
      "minimum": 0,
      "multipleOf": 1
    },
    "action_ids": {
      "description": "1–10 unique live preset IDs; overrides the single preset. Cannot be combined with motion_task_id.",
      "anyOf": [
        {
          "type": "string",
          "pattern": "^[0-9]+(\\s*,\\s*[0-9]+){0,9}$"
        },
        {
          "type": "array",
          "minItems": 1,
          "maxItems": 10,
          "uniqueItems": true,
          "items": {
            "type": "integer",
            "minimum": 0
          }
        }
      ]
    },
    "motion_task_id": {
      "title": "Generated Motion",
      "description": "Optional completed Text to Motion clip, less than three days old. Requires a biped rig. Cannot be combined with Multiple Actions.",
      "type": "string"
    }
  },
  "required": [
    "model_id",
    "rig_task_id"
  ],
  "additionalProperties": false
}

Browse schemas for every ArtEmotion model →

FAQ

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

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

Can I call Meshy Animation from the API?

Yes. Use POST /api/v1/generate with model_id: "fal-ai/meshy/animation". 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 Animation?

Start now →

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