Meshy · 3D

AI Auto-Rig API

Automatically rig a humanoid 3D character: input a static GLB (e.g. from model_generate), get back a skinned GLB with a full humanoid skeleton and baked vertex weights — ready to animate in any engine. Handles orientation + scale normalisation and weight painting automatically. Async: returns a jobId — poll GET /api/v1/jobs/:id until it succeeds, then read result.rig.url.

Available through Sorceress API

Use with an AI agentManage API keys
AI Auto-Rig model artwork

Using AI Auto-Rig in your workflow

Sorceress brings Meshy models into a shared API catalog. Select this model explicitly, check its supported inputs, and keep your API key on your server. Model capabilities differ; the schema and options on this page describe this entry rather than every model from the same brand.

  • Prepare a supported 3D character for animation with automatic rigging.
  • Use the returned rigged asset in a compatible animation workflow.

Pricing and availability

Flat 20 credits per rig, charged only on success.. Successful work is billed in Sorceress credits. Defaults and optional inputs can affect the total.

Inputs and supported options

modelUrlstring · required

https URL of a humanoid character .glb to rig — typically mesh.url from a finished model_generate job. Static/unrigged, roughly T- or A-pose, standing.

extraYawDegnumber · optional

Extra turn (0 | 90 | 180 | 270) about the up axis on top of automatic orientation. Only needed if a first rig came back mirrored or facing sideways.

API request template

Replace placeholders and choose valid values from the input contract. 

POST /api/v1/tools/model_rig
Authorization: Bearer $SORCERESS_API_KEY
Content-Type: application/json

{
  "modelUrl": "<modelUrl>"
}
Read the endpoint reference →

Completion, results and billing

Save the job identifier returned by asynchronous requests and poll the jobs endpoint until the job succeeds or fails. Do not resubmit a generation just because it is still processing. Chat returns a completed reply and usage details. A multi-step workflow can include separately billed successful steps even if a later step fails. Keep returned asset links with your project, and consult each action for its output format.

Coding agents can discover the current catalog and input requirements from the Sorceress agent instructions. Use a Sorceress key; provider credentials stay on the server.