Skip to main content
Use an Asset Pack when one request should create a coordinated collection rather than one 3D Model.

​
Generate an Asset Pack

Describe the pack and let Mint plan the individual assets, category, and shared visual direction.
Use optional controls only when you need them:
  • itemCount sets an exact count from 2–25. Otherwise Mint follows a count in the prompt, or creates 8 when none is given.
  • assetPackType overrides the inferred category. If no specialized category fits, Mint uses general_asset_pack.
  • styleGuide overrides the style inferred from the prompt. For example: "Low-poly sci-fi props with cool gray metal and cyan accents".
  • name sets the title shown in Mint.
  • riggingPose prepares humanoid character items for later rigging; it does not rig or animate them.
Use one imageUrl or 2–8 sourceImages, never both. generationMode defaults to the recommended auto workflow; choose a preset for the desired speed, quality, and cost.

​
Review and revise Previews

Item Previews are fast visual proposals, not the final 3D Models. Set generationMode: "review" to pause at them; otherwise auto continues without another lifecycle call.
  • Approve all eligible items with POST /v1/asset-packs/{assetPackId}:approve and no body.
  • Approve selected items with { "itemIds": ["..."] }.
  • Revise all or selected items with POST /v1/asset-packs/{assetPackId}:revise, feedback, and optional scope, itemIds, name, revisionEditStrength, or riggingPose.
Approval is safe against duplicate final work: items that already started or finished are reused, and Mint starts only the requested Preview-ready items that have not started yet.

​
Retrieve items and files

Read the pack with GET /v1/asset-packs/{assetPackId}. Use GET /v1/assets/asset_pack/{assetPackId}/artifact-manifest for the pack’s available files and item outputs.

​
Handle partial success

Asset Pack items finish independently. Preserve successful items when the operation is partially_succeeded.
  • Retry a failed Preview with POST /v1/asset-packs/{assetPackId}:retry.
  • Regenerate only failed final items with POST /v1/asset-packs/{assetPackId}:regenerate-failed-items.
To animate eligible character items, continue to Animation.