Mint/mcp

mint:generate:start

Animate Generated Model

animate_generated_model

Starts rigging and animation for a humanoid-riggable generated model or asset-pack item.

Parameters

Input schema generated from the registry. Required parameters are tagged.

  • model_id

    string

  • asset_pack_id

    string

  • scope

    "all_items" | "items"

  • item_ids

    array

  • animation_set_id

    "basic_locomotion" | "unarmed_combat" | "npc_social" | "emotes_and_reactions" | "dance_sampler" | "rifle_combat" | "pistol_combat" | "sword_combat" | "sword_and_shield" | "bow_combat" | "seated_npc" | "chair_interaction" | "carry_object" | "item_use" | "door_interaction"

    Stable curated set ID returned by list_model_animation_sets. Do not combine with animation_action_ids.

  • motion_prompt

    string

    Required for a custom animation request; optional when animation_set_id is provided.

  • animation_action_ids

    array

    Optional exact catalog action IDs for a custom motion_prompt. Do not combine with animation_set_id.

  • height_meters

    number

Example request

{
  "model_id": "mn785pg330fdx30ty4achjv80985ne5z",
  "animation_set_id": "basic_locomotion"
}

Example response

{
  "status": "running",
  "summary": "Model animation started.",
  "modelId": "mn785pg330fdx30ty4achjv80985ne5z",
  "targetType": "model_animation_batch",
  "targetId": "mabwalkcycle123",
  "modelAnimationBatchId": "mabwalkcycle123",
  "actionIds": [
    0,
    613,
    659,
    466,
    576,
    586
  ],
  "clips": [
    {
      "id": "macwalkcycle456",
      "actionId": 0,
      "name": "Neutral Idle",
      "status": "running"
    }
  ],
  "animationSet": {
    "id": "basic_locomotion",
    "version": 1,
    "registryVersion": 2,
    "displayName": "Basic Movement",
    "clipCount": 6,
    "actionIds": [
      0,
      613,
      659,
      466,
      576,
      586
    ]
  },
  "chatId": "j572z3a4b5c6d7e8f9g0h1i2j3",
  "chatUrl": "https://mint.gg/chat/j572z3a4b5c6d7e8f9g0h1i2j3"
}

Use cases

  • Animate a generated humanoid character.
  • Apply a discovered curated set without reconstructing its action IDs.
  • Apply chosen Meshy catalog action IDs to a model.
  • Keep the returned batch or clip ID for animation status and artifact tools.

Related Mint workflow

AI rigging and 3D animation →
Previous← retopologize_generated_modelNextget_model_animation →