Skip to main content
Use the World API to create an explorable spatial scene from a prompt and optional image guidance.

​
Generate a World

Call POST /v1/worlds:generate. Add name only for a specific Mint title; Mint derives one when omitted. generationMode defaults to auto, and generationPreset defaults to standard. See Presets for the tradeoffs.
Use one imageUrl or 2–8 sourceImages, never both.

​
Review and revise a Preview

The Preview is a fast visual proposal, not the final World. The recommended auto mode continues automatically; set generationMode: "review" to pause at preview_ready.
  • Approve with POST /v1/worlds/{worldId}:approve. Send no body.
  • Revise with POST /v1/worlds/{worldId}:revise and feedback. You can also set name, revisionEditStrength, or the next generationMode.

​
Retrieve the World and its files

Read operation.resource.id, then call GET /v1/worlds/{worldId}. The World response includes the available Preview, panorama, splat, and collider files. Use GET /v1/assets/world/{worldId}/artifact-manifest for the complete runtime manifest. Worlds stream differently from ordinary downloadable assets: load the final RAD file from runtime.runtimeUrl and the matching invisible collider from runtime.collider.runtimeUrl. Preview images remain in artifacts; the RAD runtime is intentionally not duplicated there.

​
Retry a failed World

Use POST /v1/worlds/{worldId}:retry for a terminal failed generation. The optional body can replace prompt, name, generationMode, or generationPreset. Temporary failures can reuse the original prompt. Moderated or otherwise unknown failures require a changed prompt; account or invalid input failures must be resolved before starting again.