meshy-auto-rig

Meshy Auto-Rigging Skill

Auto-rig 3D character models using the Meshy AI API. Converts static GLB/FBX models into rigged characters with walk and run animations.

When to Use This Skill

• Converting static 3D models to animated characters
• Adding skeletal rigging to humanoid models
• Generating walk/run animation cycles
• Preparing models for Three.js/React Three Fiber animation
• Batch processing multiple character models

Prerequisites

• Meshy API Key: Get one at https://www.meshy.ai/api (free tier available)
• Input model: GLB or FBX format, ideally a humanoid character in T-pose

Environment Setup

Set your API key before running:

export MESHY_API_KEY="your_key_here"

API Reference

Base URL

https://api.meshy.ai/openapi/v1

Create Rigging Task

Endpoint: POST /rigging

const response = await fetch("https://api.meshy.ai/openapi/v1/rigging", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${MESHY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model_url: modelUrl,  // URL or base64 data URI
    height_meters: 1.7,   // Normalize height (important for consistent scaling)
  }),
});

const { result: taskId } = await response.json();

Parameters:

Parameter	Type	Required	Description
model_url	string	Yes	URL to model or base64 data URI
height_meters	number	No	Target height in meters (normalizes scale)

Poll for Completion

Endpoint: GET /rigging/{taskId}

const status = await fetch(`https://api.meshy.ai/openapi/v1/rigging/${taskId}`, {
  headers: { Authorization: `Bearer ${MESHY_API_KEY}` },
}).then(r => r.json());

Response Fields:

Field	Type	Description
status	string	PENDING, IN_PROGRESS, SUCCEEDED, FAILED, EXPIRED
progress	number	0-100 completion percentage
result	object	Contains output URLs on success