mint:generate:start
Start World Generation
start_world_generation
Starts generating a 3D world from a prompt, with optional reference images.
Parameters
Input schema generated from the registry. Required parameters are tagged.
- prompt
string
- mode
"auto" | "review"
auto is the default and proceeds through final generation; review pauses at preview-ready when the user explicitly wants to inspect, revise, select, or approve previews first.
- display_name_hint
string
- chat_id
string
- image_url
string (URL)
Public direct image URL. Simple share pages with public image metadata may also work.
- source_images
array
Public direct image URLs. Simple share pages with public image metadata may also work.
- source_url
string (URL)
Source-page metadata only. Mint does not fetch this URL; use image_url or source_images for reference images.
- 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 sunlit airy atrium with marble floors, hanging plants, and tall arched windows."
}Example response
{
"status": "queued",
"assetType": "world",
"assetId": "wd123abc456def789ghi012jkl345mno",
"chatId": "j572z3a4b5c6d7e8f9g0h1i2j3",
"chatUrl": "https://mint.gg/chat/j572z3a4b5c6d7e8f9g0h1i2j3",
"chatCreated": true,
"pollIntervalMs": 30000,
"summary": "World run queued.",
"previewStrategy": "panorama",
"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": "world",
"asset_id": "wd123abc456def789ghi012jkl345mno",
"until_stage": "final"
}
}
]
}Use cases
- Kick off a world generation from a text prompt.
- Open the returned chatUrl so the user can watch the run in Mint.
Related Mint workflow
AI 3D World generation →