Skip to content

Marble World Generation

Overview

Marble is World Labs’ world-generation product rather than a traditional image or video model. World Labs describes Marble as a multimodal world model that can reconstruct, generate, and simulate persistent 3D worlds from text, images, video, and coarse 3D inputs. The repo still stores the legacy name Marble 0.1-plus, while World Labs’ current API documentation marks the older names as deprecated in favor of the newer Marble 1.x series.

API base URL

https://api.worldlabs.ai/marble/v1/

Example payload

{
  "world_prompt": {
    "type": "multi_image",
    "multi_image_prompt": [
      {
        "content": {
          "uri": "https://example.com/ref1.jpg",
          "source": "uri"
        }
      },
      {
        "content": {
          "uri": "https://example.com/ref2.jpg",
          "source": "uri"
        }
      }
    ],
    "disable_recaption": true,
    "text_prompt": "Build a stylized fantasy courtyard"
  },
  "display_name": "Generated world",
  "model": "Marble 0.1-plus",
  "seed": 12345,
  "tags": []
}

Our Current Pricing

Marble world generation is billed in the repo with a credit-style workflow formula that is then converted into USD. This is distinct from the current World Labs public API pricing page, so for portal readers it is important to separate “what World Labs sells today” from “what this application currently charges.”

Implemented constants in the workflow:

CREDITS_PER_USD = 1000
inputCredits  = 100 if the request uses video or multi-image input, else 80
outputCredits = 150 for draft quality, else 1500

Implemented formula:

cost_usd = (inputCredits + outputCredits) / CREDITS_PER_USD

So the request price is driven by only three dimensions in code: whether video is present, whether the prompt is multi-image, and whether quality is draft or non-draft. The actual world size, prompt length, and generation time do not currently affect billing.

For production accounting, calculate this amount as soon as the request is normalized because the provider response may take time and does not need to be consulted for the repo’s current billing model. If you later migrate to the public World Labs API credit schedule, keep the existing formula as a compatibility layer for older records and mark the metering source per request.

Sources