Build with Marble (3D World).
World Labs Marble. Turns a prompt, a photo, a few photos of the same place, or a video walk-through into an explorable 3D world you can fly a camera through.
Read the Marble (3D World) docs
Best for
World Labs Marble. Turns a prompt, a photo, a few photos of the same place, or a video walk-through into an explorable 3D world you can fly a camera through. Use the playground to set up a single step, then open a workflow when you want to connect more tools.
Inputs explained
- Prompt (optional)
- Describe the world. On its own this is text-to-world. Alongside an image or video it steers the result; leave it empty there and Marble writes its own caption from the media. Type: text.
- Image (optional)
- Build the world from one photo or render. An equirectangular panorama is detected automatically and skips the pano-generation step. Type: image.
- Image 2 (optional)
- Optional extra view of the SAME place. Two or more images run Marble in multi-image mode, which pins down more of the scene than one photo can. Type: image.
- Image 3 (optional)
- Optional extra view of the same place. Type: image.
- Image 4 (optional)
- Optional extra view of the same place. Type: image.
- Reference Video (optional)
- Build the world from a walk-through clip. Cannot be combined with images. that combination is refused before you are charged. Type: video.
- Quality (optional)
- Draft renders a rough world for a fraction of the price. use it to iterate on the prompt or the reference shot. Switch to Standard for the world you actually hand over. Type: text. Options: Draft (fast, cheap), Standard. Default: "marble-1.0-draft".
- World Name (optional)
- Optional label shown in the Marble viewer. Metadata only, it does not change the world. Trimmed to 64 characters. Type: text.
- Seed (optional)
- Reuse a seed to get the same world back from the same prompt. Leave empty for a new one each run. Type: number. Minimum: 0. Maximum: 4294967295.
Tips before you run
Start with the default settings and change one input at a time. Keep the result you like on your board so the next step can use it.
If you add a reference file, use a link the workflow can read. Check the inputs and credit estimate on the board before starting a run.
Working with this model
What it costs, per tier
The Pricing line above quotes the Standard tier. The node ships on Draft, and the two are far apart:
| Quality | Roughly |
|---|---|
Draft (marble-1.0-draft, the default) | about a sixth of Standard |
Standard (marble-1.1) | the price quoted above |
Both numbers are the worst case for their tier. World Labs bills the world and the panorama as separate events, and which panorama event fires is decided on their side after the request lands, so Wireflow always quotes the higher one. A world built from a panorama you already have skips that step entirely and costs less than quoted.
One node, four prompt types, decided by the wires
There is no mode dropdown. What you connect is the switch:
| What you wire | What Marble builds from |
|---|---|
| Prompt only | The description, start to finish |
| Image | That photo or render, extended into a full world |
| Image + Image 2 (and 3, 4) | Several views of the SAME place, which pins down far more of it than one photo can |
| Reference Video | A walk-through clip |
A Prompt alongside an image or a video steers the result. Leave it empty there and Marble writes its own caption from the media. Text on its own is the one case where the Prompt is required.
Wiring images AND a video is refused before you are charged. Marble has no prompt type that takes both, so quietly ignoring one side would build a world you did not ask for at full price.
An equirectangular panorama wired into Image is detected automatically and skips the pano-generation step, which is also the cheapest way to run this node if you already have one.
What comes back
Five outputs, and only the first two are pictures:
- Thumbnail and Panorama are ordinary images. Wire the panorama into an image node and it behaves like any other equirect pano.
- World Viewer URL opens the interactive world in Marble. This is the thing you send a client. It is the durable handle: the world lives on World Labs and the link does not expire.
- Splat File (SPZ) is the Gaussian splat, ready for Blender, Unreal, Unity or Houdini.
- Splat File (PLY) stays empty unless you turn on Also export PLY. Some importers want .ply rather than .spz. It is free and adds one request. If that export fails the world is still fine: the node completes, the failure shows on the card as a note, and you can open the world in the viewer.
- World ID is the id you would use to fetch the world again later.
Splats are exported in arbitrary model units, not meters. World Labs returns a metric scale factor and a ground-plane offset alongside them for anyone who needs real-world scale.
Worlds do not feed the video nodes
This is the one thing worth being blunt about. Marble worlds are explorable in the viewer, and Marble's own web app can record a camera flythrough, but the World API exposes no video export. So there is no wire from this node into a video node that produces a flythrough clip. What you can chain today is the panorama (an image) and the splat file (a download).
Draft first, always
Draft costs a fraction of Standard and exists for exactly this: get the prompt or the reference shot right, then switch Quality to Standard for the world you actually hand over. A world takes about 5 minutes either way.
World Labs limits generation starts to roughly 3 per minute across the whole Wireflow account, so a burst of Marble nodes in one workflow can hit a rate limit. If that happens the node says so and you were not charged.
Common questions
How do I use Marble (3D World) on Wireflow?
Set the inputs above and choose Open in a workflow. Sign in to save your board, then check its credit estimate before you run.
Can I use Marble (3D World) through an API?
Yes. Save a workflow with this model, then call the Wireflow run API with its workflow ID. The API tab has examples you can copy.
What changes the credit price?
The price shown uses the model defaults. Your inputs and model settings can change the total. The workflow shows an estimate before you run.
Can I connect this to another model?
Yes. Open it in a workflow and connect its output to another node with a matching input type.