mint:generate:start

Start Asset Pack Generation

start_asset_pack_generation

Starts generating a coherent pack of related 3D assets from an explicit item plan.

Parameters

Input schema generated from the registry. Required parameters are tagged.

promptrequired
string
mode
"auto" | "review"
auto is the default and proceeds through final generation; review pauses at preview-ready for revise_asset_pack_preview or approve_asset_pack_generation when the user explicitly wants to inspect, revise, select, or approve previews first.
display_name_hint
string
chat_id
string
image_url
string (URL)
source_url
string (URL)
asset_pack_typerequired
"game_asset_pack" | "city_asset_pack" | "character_asset_pack" | "car_asset_pack" | "furniture_asset_pack" | "vegetation_asset_pack" | "food_asset_pack" | "animal_asset_pack" | "aircraft_asset_pack" | "electronics_asset_pack" | "industrial_asset_pack" | "interior_asset_pack" | "clothing_asset_pack" | "general_asset_pack"
item_count
number
style_guiderequired
string
view_guide
string
itemsrequired
array
riggable_character
object
contextrequired
string
Describe the user's goal and why this tool helps in 15-25 words. Do not include credentials, personal data, identifiers, URLs, emails, or account addresses.

Example request

{
  "prompt": "A stylized forest-camp game prop kit.",
  "asset_pack_type": "game_asset_pack",
  "item_count": 4,
  "style_guide": "Hand-painted fantasy props, readable silhouettes, mossy wood and warm lantern metal, consistent three-quarter product view.",
  "items": [
    {
      "label": "Pine Gate",
      "prompt": "A small mossy pine-log camp gate."
    },
    {
      "label": "Lantern Post",
      "prompt": "A wooden lantern post with warm brass trim."
    },
    {
      "label": "Supply Crate",
      "prompt": "A square forest-camp supply crate."
    },
    {
      "label": "Bedroll Stack",
      "prompt": "A tidy stack of rolled canvas bedrolls."
    }
  ]
}

Example response

{
  "status": "queued",
  "assetType": "asset_pack",
  "assetId": "ap456forestkit789xyz012abc345",
  "chatId": "j572z3a4b5c6d7e8f9g0h1i2j3",
  "chatUrl": "https://mint.gg/chat/j572z3a4b5c6d7e8f9g0h1i2j3",
  "chatCreated": true,
  "pollIntervalMs": 30000,
  "summary": "Asset-pack run queued.",
  "approvalRequiredForFinalGeneration": false,
  "nextSteps": [
    {
      "tool": "wait_for_status",
      "action": "wait_for_final",
      "description": "Poll until Mint reports final output eligibility before trying to use files in a code project.",
      "input": {
        "asset_type": "asset_pack",
        "asset_id": "ap456forestkit789xyz012abc345",
        "until_stage": "final"
      }
    },
    {
      "tool": "list_asset_artifacts",
      "action": "list_downloadable_artifacts",
      "description": "After the asset reaches final, list downloadable artifacts and choose a downloadable artifact_id.",
      "input": {
        "asset_type": "asset_pack",
        "asset_id": "ap456forestkit789xyz012abc345"
      }
    },
    {
      "tool": "get_asset_artifact_manifest",
      "action": "fetch_artifact_manifest",
      "description": "Fetch a ready-to-copy artifact manifest with durable downloadUrls, suggested project paths, and loader hints for code-project imports.",
      "input": {
        "asset_type": "asset_pack",
        "asset_id": "ap456forestkit789xyz012abc345"
      }
    },
    {
      "tool": "get_asset_artifact",
      "action": "fetch_artifact_download_url",
      "description": "Fetch the chosen artifact to receive mintUrl plus downloadUrl for curl, R3F loaders, browser audio, or game runtime code.",
      "input": {
        "asset_type": "asset_pack",
        "asset_id": "ap456forestkit789xyz012abc345",
        "artifact_id": "<artifact_id>"
      }
    }
  ]
}

Use cases

Generate a full kit or roster instead of a single object.
Keep item labels and item prompts stable for later status, artifact, or review-mode follow-up.

Related Mint workflow

AI 3D Asset Packs →

Previous← retry_generation Nextstart_material_generation →