Skip to main content
Modeler creates a static 3D Model from a description, reference images, or both. The delivered file is a self-contained GLB that you can preview, download, and retrieve through Mint’s asset endpoints. Access: Sign in with your Mint account in Modeler, or use your Mint API key. Each request needs an explicit maximum Credit budget. Rigging, animation, and arbitrary uploaded-model editing are not supported by these endpoints.

​
Generate a model

Upload images through the existing reference-image API and use the returned reference-image IDs. Images must belong to your account. An image-only request may omit prompt.
The response is an asynchronous operation. Poll GET /v1/operations/{operationId}. Its modeler.stage describes progress; modeler.billingState distinguishes pending usage reconciliation from settled billing. A successful operation includes its model resource and modeler.artifacts.glb download URL. Pending billing does not prevent downloading an already delivered GLB.

​
Revise a model

Call POST /v1/modeler/{modelId}:revise with a new prompt, optional referenceImageIds, and maxCredits. Select a successful Modeler asset owned by your account. Each successful revision becomes a new model linked to its parent. Earlier successful results remain available even if a revision fails.

​
Credits and cancellation

Your selected Credit cap never increases automatically. Successful requests charge verified usage up to the cap and release the rest. Failed generation, export, validation, or delivery refunds the reservation. Missing usage remains pending reconciliation instead of being charged as an estimate. Call POST /v1/operations/{operationId}:cancel to cancel Modeler work. Cancellation charges verified usage already incurred, up to the cap. Repeating cancellation is safe. Other operation kinds do not support this endpoint. Reuse the same Idempotency-Key when retrying a request after a lost response. Reusing that key with different inputs returns a conflict. For a new generation or revision, use a new key.