Generate a 3D mesh (art-directed)
mesh_forgeGenerate a textured 3D mesh (GLB) from a text prompt or a reference image URL. In text mode an AI art-director first refines your prompt into an optimized single-subject spec for higher mesh quality. Renders inline in an interactive 3D viewer. Use this for a single object or prop when mesh quality matters most; for characters call text_to_avatar or forge_avatar.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prompt | No | Description of the single object to model. | |
| image_url | No | Optional http(s) URL to a reference image to reconstruct directly. | |
| 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. |