Generate a 3D avatar
text_to_avatarGenerate a textured 3D avatar (GLB) from a text description or a reference image URL. Best for characters and figures. Renders inline in an interactive 3D viewer. Use this for a character that only needs to be viewed; when it must be posed or animated call forge_avatar instead.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | No | Description of the 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. |