Generate a rigged, animation-ready avatar
forge_avatarGenerate a rigged, animation-ready 3D avatar (GLB) from a single text prompt or a reference image, in one step. Generates the mesh, then auto-rigs it with a humanoid skeleton so it is ready to pose and animate. Best for characters; objects are steered to the mesh generator. Renders inline in an interactive 3D viewer. Use this when the user wants a character they can pose or animate.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | No | Description of the character/avatar to generate. | |
| image_url | No | Optional http(s) URL to a reference image to reconstruct in 3D. | |
| idempotency_key | No | Optional retry key. Send the same key again (same caller, same arguments, within 24 hours) and you get the original job back instead of a second generation, so a retry after a timeout cannot burn quota twice. Use a fresh key for each distinct request. A failed attempt is not remembered, so its key can be reused. | |
| allow_non_humanoid | No | Set true to rig a non-humanoid subject anyway (rigging assumes a humanoid figure). |