Auto-rig API

A skeleton and skin weights for a character, as a GLB ready to pose and animate; then the animate tool puts animations on it. Humanoids with every model: tripo-rig names the bones for an engine (bone_names), rodin-rig is the fastest (about 30 s), meshy-rig adds an FBX of the rig. Four-legged animals with rodin-rig only (body: horse, dog or cow), which come with their kind's walk and run (walk_glb, run_glb).

Tool id auto-rig on the REST API (POST https://3dvalley.com/api/v1/jobs); MCP tool rig_model on https://3dvalley.com/mcp. Paid in credits (1 credit = $0.01), taken when the job starts and given back if it fails. The general rules (keys, idempotency, waiting, webhooks) are in the API docs.

The free CC0 library holds rigged characters already: GET /api/v1/assets?type=model&rigged=true (MCP: search_assets with rigged: true), ready for the animate tool.

Models and prices

Model	Name	Price	Time	What it is
tripo-rig (default)	Tripo	45 credits	about 30 s	Rigs humanoid characters with the bone names of Mixamo, Unity, Unreal or VRM, so an engine's own animations play on them.
meshy-rig	Meshy	35 credits	about 110 s	Rigs humanoid characters, with an FBX of the rig as well.
rodin-rig	Rodin	35 credits	about 25 s	Rigs humanoids and four-legged animals in half a minute, fingers included; an animal comes with a walk and a run of its kind.

Input

Field	Required
mesh	yes	A mesh (GLB, glTF, OBJ, PLY or STL) as an https URL, an upload id (upl_...), a library id (ph:wooden_barrel_01) or an earlier job (job_... or its asset id 3dv:...). One character, best standing in a T-pose or A-pose; an animal on all fours, facing +Z.

Options

Option	Type	Values
bone_names	string	tripo, mixamo, unity, unreal, vrm	The bone names, so an engine's own animations play on it (tripo-rig). Default tripo.
body	string	humanoid, horse, dog, cow	What is rigged (rodin-rig): humanoid (humanoid), horse (horse or deer), dog (dog or wolf), cow (cow or bull). An animal comes with its kind's walk and run. Default humanoid.
animations	list	preset:idle, preset:walk, preset:run, preset:jump, preset:turn, preset:climb, preset:dive, preset:slash, preset:shoot, preset:hurt, preset:fall	Deprecated: Tripo's preset animations on a tripo-rig rig (17 credits each), up to 5. Use the animate tool instead: 79 free animations on any rig, or any motion described in words.

Output

Files: glb, fbx, walk_glb, run_glb. glb is the rig in its rest pose, with no animations: put them on with the animate tool. fbx comes from meshy-rig. walk_glb and run_glb come from rodin-rig with an animal's body: its walk and its run, each a GLB of the rig.

Example

curl -X POST https://3dvalley.com/api/v1/jobs \
  -H "Authorization: Bearer $THREEDVALLEY_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Prefer: wait=50" \
  -H "Content-Type: application/json" \
  -d '{"tool":"auto-rig","model":"rodin-rig","input":{"mesh":"job_8Hq2..."}}'

From an MCP client:

rig_model({"mesh":"job_8Hq2...","model":"rodin-rig"})

Limits

• max_image_bytes: 10,485,760
• max_mesh_bytes: 62,914,560