@tanstack/ai-worldlabs 0.0.0 → 0.1.0

package/dist/esm/generated/types.gen.d.ts

@@ -0,0 +1,1610 @@
+export type ClientOptions = {
+    baseUrl: 'https://api.worldlabs.ai' | (string & {});
+};
+/**
+ * Content
+ *
+ * Represents content (media, text, images) that can be stored inline or via URL.
+ *
+ * Supports both direct data storage (up to 10MB) and URL references (up to 20MB).
+ */
+export type Content = {
+    /**
+     * Data Base64
+     */
+    data_base64?: string | null;
+    /**
+     * Extension
+     *
+     * File extension without dot
+     */
+    extension?: string | null;
+    /**
+     * Uri
+     */
+    uri?: string | null;
+};
+/**
+ * CreditsResponse
+ *
+ * Remaining credits for the authenticated API user.
+ */
+export type CreditsResponse = {
+    /**
+     * Remaining Credits
+     *
+     * Remaining API credits available to the authenticated user.
+     */
+    remaining_credits: number;
+};
+/**
+ * DataBase64Reference
+ *
+ * Reference to content via base64-encoded data.
+ */
+export type DataBase64Reference = {
+    /**
+     * Data Base64
+     *
+     * Base64-encoded content data
+     */
+    data_base64: string;
+    /**
+     * Extension
+     *
+     * File extension without dot (e.g., 'jpg', 'png')
+     */
+    extension?: string | null;
+    /**
+     * Source
+     */
+    source?: 'data_base64';
+};
+/**
+ * DeleteWorldResponse
+ *
+ * Response from world deletion endpoint.
+ */
+export type DeleteWorldResponse = {
+    /**
+     * Deleted
+     *
+     * Whether the world was successfully deleted
+     */
+    deleted: boolean;
+    /**
+     * World Id
+     *
+     * ID of the deleted world
+     */
+    world_id: string;
+};
+/**
+ * DepthPanoPrompt
+ *
+ * For models conditioned on a depth pano and text.
+ * When depth_pano_image is a log-encoded PNG, z_min and z_max are required
+ * to decode it correctly. When it is an EXR file containing raw float depth
+ * values, z_min and z_max will both be ignored.
+ * Please set z_min and z_max both to None when using an EXR file.
+ */
+export type DepthPanoPrompt = {
+    depth_pano_image: Content;
+    /**
+     * Text Prompt
+     */
+    text_prompt?: string | null;
+    /**
+     * Type
+     */
+    type?: 'depth-pano';
+    /**
+     * Z Max
+     */
+    z_max?: number | null;
+    /**
+     * Z Min
+     */
+    z_min?: number | null;
+};
+/**
+ * ExportWorldRequest
+ *
+ * Request to export a generated world asset.
+ */
+export type ExportWorldRequest = {
+    /**
+     * Asset Type
+     *
+     * Asset family to export: 'splats' or 'mesh'.
+     */
+    asset_type: 'splats' | 'mesh';
+    /**
+     * Format
+     *
+     * Requested export format.
+     */
+    format: 'ply' | 'glb';
+    /**
+     * Mesh Variant
+     *
+     * Mesh variant to return when an HQ mesh already exists.
+     */
+    mesh_variant?: 'textured' | 'vertex_colored';
+    /**
+     * Resolution
+     *
+     * Splat resolution to convert when exporting splats as PLY.
+     */
+    resolution?: 'full_res' | '500k' | '150k' | '100k';
+};
+/**
+ * ExportWorldResponse
+ *
+ * Response from world export endpoint.
+ */
+export type ExportWorldResponse = {
+    /**
+     * Settled credit cost for the operation. Populated only on successful completion.
+     */
+    cost?: OperationCost | null;
+    /**
+     * Created At
+     *
+     * Creation timestamp
+     */
+    created_at?: string | null;
+    /**
+     * Done
+     *
+     * True if the operation is completed
+     */
+    done: boolean;
+    /**
+     * Error information if the operation failed
+     */
+    error?: OperationError | null;
+    /**
+     * Expires At
+     *
+     * Expiration timestamp
+     */
+    expires_at?: string | null;
+    /**
+     * Metadata
+     *
+     * Service-specific metadata, such as progress percentage
+     */
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Operation Id
+     *
+     * Operation identifier
+     */
+    operation_id: string;
+    /**
+     * Result payload when done=true and no error. Structure depends on operation type.
+     */
+    response?: ExportWorldResult | null;
+    /**
+     * Updated At
+     *
+     * Last update timestamp
+     */
+    updated_at?: string | null;
+};
+/**
+ * ExportWorldResult
+ *
+ * Downloadable exported world asset.
+ */
+export type ExportWorldResult = {
+    /**
+     * Asset Type
+     *
+     * Exported asset family
+     */
+    asset_type: 'splats' | 'mesh';
+    /**
+     * Format
+     *
+     * Exported file format
+     */
+    format: 'ply' | 'glb';
+    /**
+     * Mesh Variant
+     *
+     * Mesh variant returned for this export, if applicable
+     */
+    mesh_variant?: 'textured' | 'vertex_colored' | null;
+    /**
+     * Resolution
+     *
+     * Splat resolution used for this export, if applicable
+     */
+    resolution?: string | null;
+    /**
+     * Url
+     *
+     * Download URL for the exported asset
+     */
+    url: string;
+};
+/**
+ * GenerateWorldResponse
+ *
+ * Response from world generation endpoint.
+ */
+export type GenerateWorldResponse = {
+    /**
+     * Settled credit cost for the operation. Populated only on successful completion.
+     */
+    cost?: OperationCost | null;
+    /**
+     * Created At
+     *
+     * Creation timestamp
+     */
+    created_at?: string | null;
+    /**
+     * Done
+     *
+     * True if the operation is completed
+     */
+    done: boolean;
+    /**
+     * Error information if the operation failed
+     */
+    error?: OperationError | null;
+    /**
+     * Expires At
+     *
+     * Expiration timestamp
+     */
+    expires_at?: string | null;
+    /**
+     * Metadata
+     *
+     * Service-specific metadata, such as progress percentage
+     */
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Operation Id
+     *
+     * Operation identifier
+     */
+    operation_id: string;
+    /**
+     * Response
+     *
+     * Result payload when done=true and no error. Structure depends on operation type.
+     */
+    response?: unknown | null;
+    /**
+     * Updated At
+     *
+     * Last update timestamp
+     */
+    updated_at?: string | null;
+};
+/**
+ * GetOperationResponse[Union[World, PanoDepthToRgbResult, ExportWorldResult]]
+ */
+export type GetOperationResponseUnionWorldPanoDepthToRgbResultExportWorldResult = {
+    /**
+     * Settled credit cost for the operation. Populated only on successful completion.
+     */
+    cost?: OperationCost | null;
+    /**
+     * Created At
+     *
+     * Creation timestamp
+     */
+    created_at?: string | null;
+    /**
+     * Done
+     *
+     * True if the operation is completed
+     */
+    done: boolean;
+    /**
+     * Error information if the operation failed
+     */
+    error?: OperationError | null;
+    /**
+     * Expires At
+     *
+     * Expiration timestamp
+     */
+    expires_at?: string | null;
+    /**
+     * Metadata
+     *
+     * Service-specific metadata, such as progress percentage
+     */
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Operation Id
+     *
+     * Operation identifier
+     */
+    operation_id: string;
+    /**
+     * Response
+     *
+     * Result payload when done=true and no error. Structure depends on operation type.
+     */
+    response?: World | PanoDepthToRgbResult | ExportWorldResult | null;
+    /**
+     * Updated At
+     *
+     * Last update timestamp
+     */
+    updated_at?: string | null;
+};
+/**
+ * HTTPValidationError
+ */
+export type HttpValidationError = {
+    /**
+     * Detail
+     */
+    detail?: Array<ValidationError>;
+};
+/**
+ * ImagePrompt
+ *
+ * Image-to-world generation.
+ *
+ * Generates a world from an image. text_prompt is optional - if not provided,
+ * it will be generated via recaptioning.
+ *
+ * Recommended image formats: jpg, jpeg, png, webp.
+ */
+export type ImagePrompt = {
+    /**
+     * Disable Recaption
+     *
+     * If True, use text_prompt as-is without recaptioning
+     */
+    disable_recaption?: boolean | null;
+    /**
+     * Image Prompt
+     *
+     * Image content for world generation
+     */
+    image_prompt: ({
+        source: 'media_asset';
+    } & MediaAssetReference) | ({
+        source: 'uri';
+    } & UriReference) | ({
+        source: 'data_base64';
+    } & DataBase64Reference);
+    /**
+     * How to treat the image input as a panorama. `auto` detects valid equirectangular panoramas, `true` always uses the image as a panorama, and `false` treats it as a standard image.
+     */
+    is_pano?: PanoDetectionMode;
+    /**
+     * Text Prompt
+     *
+     * Optional text guidance (auto-generated if not provided)
+     */
+    text_prompt?: string | null;
+    /**
+     * Type
+     */
+    type?: 'image';
+};
+/**
+ * ImageryAssets
+ *
+ * Imagery asset URLs.
+ */
+export type ImageryAssets = {
+    /**
+     * Pano Url
+     *
+     * Panorama image URL
+     */
+    pano_url?: string | null;
+};
+/**
+ * InpaintPanoPrompt
+ *
+ * For models that inpaint the masked portion of a pano image.
+ */
+export type InpaintPanoPrompt = {
+    pano_image: Content;
+    pano_mask: Content;
+    /**
+     * Text Prompt
+     */
+    text_prompt?: string | null;
+    /**
+     * Type
+     */
+    type?: 'inpaint-pano';
+};
+/**
+ * ListWorldsRequest
+ *
+ * Request to list API-generated worlds with optional filters.
+ */
+export type ListWorldsRequest = {
+    /**
+     * Created After
+     *
+     * Filter worlds created after this timestamp (inclusive)
+     */
+    created_after?: string | null;
+    /**
+     * Created Before
+     *
+     * Filter worlds created before this timestamp (exclusive)
+     */
+    created_before?: string | null;
+    /**
+     * Is Public
+     *
+     * Filter by visibility. true=public only, false=private only, null=all
+     */
+    is_public?: boolean | null;
+    /**
+     * Model
+     *
+     * Filter by model used for generation. Legacy names are deprecated; use the new lowercase names.
+     */
+    model?: 'marble-1.0-draft' | 'marble-1.0' | 'marble-1.1' | 'marble-1.1-plus' | 'Marble 0.1-mini' | 'Marble 0.1-plus' | 'Marble 1.1-plus' | null;
+    /**
+     * Page Size
+     *
+     * Number of results per page (1-100)
+     */
+    page_size?: number;
+    /**
+     * Page Token
+     *
+     * Cursor token for pagination (opaque base64 string from previous response). Use cursor from next_page_token in previous response for consistent pagination.
+     */
+    page_token?: string | null;
+    /**
+     * Sort By
+     *
+     * Sort results by created_at or updated_at
+     */
+    sort_by?: 'created_at' | 'updated_at';
+    /**
+     * Status
+     *
+     * Filter by world status
+     */
+    status?: 'SUCCEEDED' | 'PENDING' | 'FAILED' | 'RUNNING' | null;
+    /**
+     * Tags
+     *
+     * Filter by tags (returns worlds with ANY of these tags)
+     */
+    tags?: Array<string> | null;
+};
+/**
+ * ListWorldsResponse
+ *
+ * Response containing a list of API-generated worlds.
+ */
+export type ListWorldsResponse = {
+    /**
+     * Next Page Token
+     *
+     * Token for fetching the next page of results
+     */
+    next_page_token?: string | null;
+    /**
+     * Worlds
+     *
+     * List of worlds
+     */
+    worlds: Array<World>;
+};
+/**
+ * MediaAsset
+ *
+ * A user-uploaded media asset stored in managed storage.
+ *
+ * MediaAssets can be images, videos, or binary blobs that are used
+ * as input to world generation.
+ */
+export type MediaAsset = {
+    /**
+     * Created At
+     *
+     * Creation timestamp
+     */
+    created_at: string;
+    /**
+     * Extension
+     *
+     * File extension without dot
+     */
+    extension?: string | null;
+    /**
+     * File Name
+     *
+     * File name
+     */
+    file_name: string;
+    /**
+     * High-level media type
+     */
+    kind: MediaAssetKind;
+    /**
+     * Media Asset Id
+     *
+     * Server-generated media asset identifier
+     */
+    media_asset_id: string;
+    /**
+     * Metadata
+     *
+     * Optional application-specific metadata
+     */
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Updated At
+     *
+     * Last update timestamp
+     */
+    updated_at?: string | null;
+};
+/**
+ * MediaAssetKind
+ *
+ * High-level media asset type.
+ */
+export type MediaAssetKind = 'image' | 'video';
+/**
+ * MediaAssetPrepareUploadRequest
+ *
+ * Request to prepare a media asset upload.
+ */
+export type MediaAssetPrepareUploadRequest = {
+    /**
+     * Extension
+     *
+     * File extension without dot
+     */
+    extension?: string | null;
+    /**
+     * File Name
+     *
+     * File name
+     */
+    file_name: string;
+    /**
+     * High-level media type
+     */
+    kind: MediaAssetKind;
+    /**
+     * Metadata
+     *
+     * Optional application-specific metadata
+     */
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+};
+/**
+ * MediaAssetPrepareUploadResponse
+ *
+ * Response from preparing a media asset upload.
+ */
+export type MediaAssetPrepareUploadResponse = {
+    /**
+     * The created media asset
+     */
+    media_asset: MediaAsset;
+    /**
+     * Upload URL information
+     */
+    upload_info: UploadUrlInfo;
+};
+/**
+ * MediaAssetReference
+ *
+ * Reference to a previously uploaded MediaAsset.
+ */
+export type MediaAssetReference = {
+    /**
+     * Media Asset Id
+     *
+     * ID of a MediaAsset resource previously created and marked READY
+     */
+    media_asset_id: string;
+    /**
+     * Source
+     */
+    source?: 'media_asset';
+};
+/**
+ * MeshAssets
+ *
+ * Mesh asset URLs.
+ */
+export type MeshAssets = {
+    /**
+     * Collider Mesh Url
+     *
+     * Collider mesh URL
+     */
+    collider_mesh_url?: string | null;
+    /**
+     * Full Res Mesh Url
+     *
+     * Full-resolution vertex-colored mesh URL
+     */
+    full_res_mesh_url?: string | null;
+    /**
+     * Hq Mesh Url
+     *
+     * High-quality textured mesh URL
+     */
+    hq_mesh_url?: string | null;
+};
+/**
+ * MultiImagePrompt
+ *
+ * Multi-image-to-world generation.
+ *
+ * Generates a world from multiple images. text_prompt is optional.
+ *
+ * Recommended image formats: jpg, jpeg, png, webp.
+ */
+export type MultiImagePromptInput = {
+    /**
+     * Disable Recaption
+     *
+     * If True, use text_prompt as-is without recaptioning
+     */
+    disable_recaption?: boolean | null;
+    /**
+     * Multi Image Prompt
+     *
+     * List of images with optional spherical locations
+     */
+    multi_image_prompt: Array<SphericallyLocatedContentInput>;
+    /**
+     * Reconstruct Images
+     *
+     * Whether to use reconstruction mode (allows up to 8 images, otherwise 4)
+     */
+    reconstruct_images?: boolean;
+    /**
+     * Text Prompt
+     *
+     * Optional text guidance (auto-generated if not provided)
+     */
+    text_prompt?: string | null;
+    /**
+     * Type
+     */
+    type?: 'multi-image';
+};
+/**
+ * MultiImagePrompt
+ *
+ * For world models supporting multi-image (+ text) input.
+ */
+export type MultiImagePromptOutput = {
+    /**
+     * Multi Image Prompt
+     */
+    multi_image_prompt: Array<SphericallyLocatedContentOutput>;
+    /**
+     * Reconstruct Images
+     */
+    reconstruct_images?: boolean;
+    /**
+     * Text Prompt
+     */
+    text_prompt?: string | null;
+    /**
+     * Type
+     */
+    type?: 'multi-image';
+};
+/**
+ * OperationCost
+ *
+ * Settled credit cost for a successful operation.
+ */
+export type OperationCost = {
+    /**
+     * Line Items
+     *
+     * Usage events that make up the operation's total credits
+     */
+    line_items?: Array<OperationCostLineItem>;
+    /**
+     * Total Credits
+     *
+     * Total credits charged for the operation
+     */
+    total_credits: number;
+};
+/**
+ * OperationCostLineItem
+ *
+ * A single usage event contributing to an operation's total credits.
+ */
+export type OperationCostLineItem = {
+    /**
+     * Credits
+     *
+     * Credits charged for this usage event
+     */
+    credits: number;
+    /**
+     * Name
+     *
+     * Human-readable usage event name
+     */
+    name: string;
+};
+/**
+ * OperationError
+ *
+ * Error information for a failed operation.
+ */
+export type OperationError = {
+    /**
+     * Code
+     *
+     * Error code
+     */
+    code?: number | null;
+    /**
+     * Message
+     *
+     * Error message
+     */
+    message?: string | null;
+};
+/**
+ * Operation[PanoDepthToRgbResult]
+ */
+export type OperationPanoDepthToRgbResult = {
+    /**
+     * Settled credit cost for the operation. Populated only on successful completion.
+     */
+    cost?: OperationCost | null;
+    /**
+     * Created At
+     *
+     * Creation timestamp
+     */
+    created_at?: string | null;
+    /**
+     * Done
+     *
+     * True if the operation is completed
+     */
+    done: boolean;
+    /**
+     * Error information if the operation failed
+     */
+    error?: OperationError | null;
+    /**
+     * Expires At
+     *
+     * Expiration timestamp
+     */
+    expires_at?: string | null;
+    /**
+     * Metadata
+     *
+     * Service-specific metadata, such as progress percentage
+     */
+    metadata?: {
+        [key: string]: unknown;
+    } | null;
+    /**
+     * Operation Id
+     *
+     * Operation identifier
+     */
+    operation_id: string;
+    /**
+     * Result payload when done=true and no error. Structure depends on operation type.
+     */
+    response?: PanoDepthToRgbResult | null;
+    /**
+     * Updated At
+     *
+     * Last update timestamp
+     */
+    updated_at?: string | null;
+};
+/**
+ * PanoDepthToRgbRequest
+ *
+ * Request to generate an RGB panorama from a depth panorama.
+ *
+ * Provide a depth panorama and a text prompt describing
+ * the desired appearance. The depth map supplies the
+ * scene geometry; the model synthesizes textures that
+ * loosely adhere to that geometry and returns a panoramic RGB image.
+ *
+ * Accepted depth inputs:
+ *
+ * * **EXR**: float depth values. Omit ``z_min``
+ * and ``z_max``.
+ * * **PNG**: depth values normalized to [0, 1].
+ * Provide both ``z_min`` and ``z_max`` so the service
+ * can decode the PNG correctly.
+ *
+ * For a complete PNG-based workflow, see the
+ * `web-chisel-depth-png example <https://github.com/worldlabsai/worldlabs-api-examples/tree/main/web-chisel-depth-png>`.
+ *
+ * This endpoint returns a long-running ``Operation``.
+ * Poll ``GET /operations/{operation_id}`` until
+ * ``done`` is ``true``, then read the generated
+ * panorama URL from ``response.pano_url``.
+ */
+export type PanoDepthToRgbRequest = {
+    /**
+     * Depth Pano Image
+     *
+     * Depth panorama image (EXR or PNG). Provide via URI, media_asset, or base64 (max 100 MB).
+     */
+    depth_pano_image: ({
+        source: 'media_asset';
+    } & MediaAssetReference) | ({
+        source: 'uri';
+    } & UriReference) | ({
+        source: 'data_base64';
+    } & DataBase64Reference);
+    /**
+     * Seed
+     *
+     * Random seed for reproducible generation.
+     */
+    seed?: number | null;
+    /**
+     * Text Prompt
+     *
+     * Text description of the desired appearance.
+     */
+    text_prompt: string;
+    /**
+     * Z Max
+     *
+     * Maximum depth. Required for PNG depth maps (normalized to [0, 1]). Must be provided together with z_min and must be greater than z_min. Omit for EXR depth maps.
+     */
+    z_max?: number | null;
+    /**
+     * Z Min
+     *
+     * Minimum depth. Required for PNG depth maps (normalized to [0, 1]). Must be provided together with z_max. Omit for EXR depth maps.
+     */
+    z_min?: number | null;
+};
+/**
+ * PanoDepthToRgbResult
+ *
+ * Result from depth-to-RGB panorama generation.
+ *
+ * Returned inside ``Operation.response`` when the
+ * operation completes successfully (``done=true``).
+ */
+export type PanoDepthToRgbResult = {
+    /**
+     * Pano Url
+     *
+     * URL of the generated RGB panorama image. Available when the operation succeeds.
+     */
+    pano_url?: string | null;
+};
+export type PanoDetectionMode = 'auto' | true | false;
+/**
+ * Permission
+ *
+ * Access control permissions for a resource.
+ */
+export type Permission = {
+    /**
+     * Allow Id Access
+     */
+    allow_id_access?: boolean;
+    /**
+     * Allowed Readers
+     */
+    allowed_readers?: Array<string>;
+    /**
+     * Allowed Writers
+     */
+    allowed_writers?: Array<string>;
+    /**
+     * Public
+     */
+    public?: boolean;
+};
+/**
+ * Prompt
+ *
+ * For world models generating a world from a single image (+ text).
+ * Images can be generated using the :image-generation method.
+ * If no text prompt is provided, it will be generated via recaption.
+ */
+export type Prompt = {
+    image_prompt: Content;
+    /**
+     * Is Pano
+     */
+    is_pano?: boolean;
+    /**
+     * Text Prompt
+     */
+    text_prompt?: string | null;
+    /**
+     * Type
+     */
+    type?: 'image';
+};
+/**
+ * SphericallyLocatedContent
+ *
+ * Content with a preferred location on the sphere.
+ */
+export type SphericallyLocatedContentInput = {
+    /**
+     * Azimuth
+     *
+     * Azimuth angle in degrees
+     */
+    azimuth?: number | null;
+    /**
+     * Content
+     *
+     * The content at this location
+     */
+    content: ({
+        source: 'media_asset';
+    } & MediaAssetReference) | ({
+        source: 'uri';
+    } & UriReference) | ({
+        source: 'data_base64';
+    } & DataBase64Reference);
+};
+/**
+ * SphericallyLocatedContent
+ *
+ * Content with a preferred location on the sphere.
+ */
+export type SphericallyLocatedContentOutput = {
+    /**
+     * Azimuth
+     */
+    azimuth?: number | null;
+    /**
+     * Data Base64
+     */
+    data_base64?: string | null;
+    /**
+     * Extension
+     *
+     * File extension without dot
+     */
+    extension?: string | null;
+    /**
+     * Uri
+     */
+    uri?: string | null;
+};
+/**
+ * SplatAssets
+ *
+ * Gaussian splat asset URLs.
+ */
+export type SplatAssets = {
+    /**
+     * Semantic metadata for the world
+     */
+    semantics_metadata?: WorldSemanticsMetadata | null;
+    /**
+     * Spz Urls
+     *
+     * URLs for SPZ format Gaussian splat files
+     */
+    spz_urls?: {
+        [key: string]: string;
+    } | null;
+};
+/**
+ * UploadUrlInfo
+ *
+ * Information required to upload raw bytes directly to storage.
+ */
+export type UploadUrlInfo = {
+    /**
+     * Curl Example
+     *
+     * Optional curl example for convenience
+     */
+    curl_example?: string | null;
+    /**
+     * Required Headers
+     *
+     * Headers that MUST be included when uploading (e.g. Content-Type)
+     */
+    required_headers?: {
+        [key: string]: string;
+    } | null;
+    /**
+     * Upload Method
+     *
+     * Upload method
+     */
+    upload_method: string;
+    /**
+     * Upload Url
+     *
+     * Signed URL for uploading bytes via PUT
+     */
+    upload_url: string;
+};
+/**
+ * UriReference
+ *
+ * Reference to content via a publicly accessible URL.
+ */
+export type UriReference = {
+    /**
+     * Source
+     */
+    source?: 'uri';
+    /**
+     * Uri
+     *
+     * Publicly accessible URL pointing to the media
+     */
+    uri: string;
+};
+/**
+ * ValidationError
+ */
+export type ValidationError = {
+    /**
+     * Location
+     */
+    loc: Array<string | number>;
+    /**
+     * Message
+     */
+    msg: string;
+    /**
+     * Error Type
+     */
+    type: string;
+};
+/**
+ * VideoPrompt
+ *
+ * Video-to-world generation.
+ *
+ * Generates a world from a video. text_prompt is optional.
+ *
+ * Recommended video formats: mp4, webm, mov, avi.
+ * Maximum video size: 100MB.
+ */
+export type VideoPromptInput = {
+    /**
+     * Disable Recaption
+     *
+     * If True, use text_prompt as-is without recaptioning
+     */
+    disable_recaption?: boolean | null;
+    /**
+     * Text Prompt
+     *
+     * Optional text guidance (auto-generated if not provided)
+     */
+    text_prompt?: string | null;
+    /**
+     * Type
+     */
+    type?: 'video';
+    /**
+     * Video Prompt
+     *
+     * Video content for world generation
+     */
+    video_prompt: ({
+        source: 'media_asset';
+    } & MediaAssetReference) | ({
+        source: 'uri';
+    } & UriReference) | ({
+        source: 'data_base64';
+    } & DataBase64Reference);
+};
+/**
+ * VideoPrompt
+ *
+ * For world models supporting video (+ text) input.
+ */
+export type VideoPromptOutput = {
+    /**
+     * Text Prompt
+     */
+    text_prompt?: string | null;
+    /**
+     * Type
+     */
+    type?: 'video';
+    video_prompt: Content;
+};
+/**
+ * World
+ *
+ * A generated world, including asset URLs.
+ */
+export type World = {
+    /**
+     * Generated world assets
+     */
+    assets?: WorldAssets | null;
+    /**
+     * Created At
+     *
+     * Creation timestamp
+     */
+    created_at?: string | null;
+    /**
+     * Display Name
+     *
+     * Display name
+     */
+    display_name: string;
+    /**
+     * Model
+     *
+     * Model used for generation
+     */
+    model?: string | null;
+    /**
+     * Access control permissions for the world
+     */
+    permission?: Permission | null;
+    /**
+     * Tags
+     *
+     * Tags associated with the world
+     */
+    tags?: Array<string> | null;
+    /**
+     * Updated At
+     *
+     * Last update timestamp
+     */
+    updated_at?: string | null;
+    /**
+     * World Id
+     *
+     * World identifier
+     */
+    world_id: string;
+    /**
+     * World Marble Url
+     *
+     * World Marble URL
+     */
+    world_marble_url: string;
+    /**
+     * World Prompt
+     *
+     * World prompt
+     */
+    world_prompt?: ({
+        type: 'text';
+    } & WorldTextPromptOutput) | ({
+        type: 'image';
+    } & Prompt) | ({
+        type: 'multi-image';
+    } & MultiImagePromptOutput) | ({
+        type: 'video';
+    } & VideoPromptOutput) | ({
+        type: 'depth-pano';
+    } & DepthPanoPrompt) | ({
+        type: 'inpaint-pano';
+    } & InpaintPanoPrompt) | null;
+};
+/**
+ * WorldAssets
+ *
+ * Downloadable outputs of world generation.
+ */
+export type WorldAssets = {
+    /**
+     * Caption
+     *
+     * AI-generated description of the world
+     */
+    caption?: string | null;
+    /**
+     * Imagery assets
+     */
+    imagery?: ImageryAssets | null;
+    /**
+     * Mesh assets
+     */
+    mesh?: MeshAssets | null;
+    /**
+     * Gaussian splat assets
+     */
+    splats?: SplatAssets | null;
+    /**
+     * Thumbnail Url
+     *
+     * Thumbnail URL for the world
+     */
+    thumbnail_url?: string | null;
+};
+/**
+ * WorldSemanticsMetadata
+ *
+ * Semantic metadata describing how to interpret the generated splat
+ * asset in real-world units.
+ *
+ * The exported asset is in arbitrary model units. Apply the transform
+ * below to convert to a metric, ground-aligned frame:
+ *
+ * metric_xyz = raw_xyz * metric_scale_factor
+ * aligned_xyz = metric_xyz - (0, ground_plane_offset, 0)
+ *
+ * Both fields are populated on every world generated by the current
+ * pipeline. They remain Optional only for backwards compatibility with
+ * worlds generated before December 2025, which predate metric-scale
+ * estimation.
+ *
+ * TODO: once pre-December-2025 worlds are migrated or aged out, tighten
+ * these fields to non-Optional and drop the `| None` from the type.
+ */
+export type WorldSemanticsMetadata = {
+    /**
+     * Ground Plane Offset
+     *
+     * Vertical (Y-axis) offset, in meters, of the detected ground plane in the metric-scaled frame. Subtract from Y after applying `metric_scale_factor` to place the ground at y=0.
+     */
+    ground_plane_offset?: number | null;
+    /**
+     * Metric Scale Factor
+     *
+     * Multiplicative factor that converts raw asset coordinates to meters. Multiply all XYZ positions (and isotropic scales) by this value. A value of 1.0 means scale could not be inferred and the asset was left in model units.
+     */
+    metric_scale_factor?: number | null;
+};
+/**
+ * WorldTextPrompt
+ *
+ * Text-to-world generation.
+ *
+ * Generates a world from a text description. text_prompt is REQUIRED.
+ */
+export type WorldTextPromptInput = {
+    /**
+     * Disable Recaption
+     *
+     * If True, use text_prompt as-is without recaptioning
+     */
+    disable_recaption?: boolean | null;
+    /**
+     * Text Prompt
+     *
+     * Optional text guidance (auto-generated if not provided)
+     */
+    text_prompt?: string | null;
+    /**
+     * Type
+     */
+    type?: 'text';
+};
+/**
+ * WorldTextPrompt
+ *
+ * Input prompt class for text-conditioned world generation.
+ */
+export type WorldTextPromptOutput = {
+    /**
+     * Text Prompt
+     */
+    text_prompt?: string | null;
+    /**
+     * Type
+     */
+    type?: 'text';
+};
+/**
+ * WorldsGenerateRequest
+ *
+ * Request to generate a world from text, image, multi-image, or video input.
+ */
+export type WorldsGenerateRequest = {
+    /**
+     * Display Name
+     *
+     * Optional human-readable title for the world (max 64 characters). Stored as world metadata and returned in world responses; does not affect generation. If omitted, World Labs may generate a title from the prompt.
+     */
+    display_name?: string | null;
+    /**
+     * Model
+     *
+     * The model to use for generation. marble-1.1-plus includes dynamic world sizing. Legacy names ('Marble 0.1-plus', etc.) still work but are deprecated and will be removed in a future release.
+     */
+    model?: 'marble-1.0-draft' | 'marble-1.0' | 'marble-1.1' | 'marble-1.1-plus' | 'Marble 0.1-mini' | 'Marble 0.1-plus' | 'Marble 1.1-plus';
+    /**
+     * The permission for the world
+     */
+    permission?: Permission;
+    /**
+     * Seed
+     *
+     * Random seed for generation
+     */
+    seed?: number | null;
+    /**
+     * Tags
+     *
+     * Optional tags for the world (max 10 tags, each up to 32 characters)
+     */
+    tags?: Array<string> | null;
+    /**
+     * World Prompt
+     *
+     * The prompt specifying how to generate the world
+     */
+    world_prompt: ({
+        type: 'text';
+    } & WorldTextPromptInput) | ({
+        type: 'image';
+    } & ImagePrompt) | ({
+        type: 'multi-image';
+    } & MultiImagePromptInput) | ({
+        type: 'video';
+    } & VideoPromptInput);
+};
+export type GetCreditsMarbleV1CreditsGetData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/marble/v1/credits';
+};
+export type GetCreditsMarbleV1CreditsGetResponses = {
+    /**
+     * Successful Response
+     */
+    200: CreditsResponse;
+};
+export type GetCreditsMarbleV1CreditsGetResponse = GetCreditsMarbleV1CreditsGetResponses[keyof GetCreditsMarbleV1CreditsGetResponses];
+export type GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetData = {
+    body?: never;
+    path: {
+        /**
+         * Media Asset Id
+         */
+        media_asset_id: string;
+    };
+    query?: never;
+    url: '/marble/v1/media-assets/{media_asset_id}';
+};
+export type GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetErrors = {
+    /**
+     * Validation Error
+     */
+    422: HttpValidationError;
+};
+export type GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetError = GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetErrors[keyof GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetErrors];
+export type GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetResponses = {
+    /**
+     * Successful Response
+     */
+    200: MediaAsset;
+};
+export type GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetResponse = GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetResponses[keyof GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetResponses];
+export type PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostData = {
+    body: MediaAssetPrepareUploadRequest;
+    path?: never;
+    query?: never;
+    url: '/marble/v1/media-assets:prepare_upload';
+};
+export type PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostErrors = {
+    /**
+     * Validation Error
+     */
+    422: HttpValidationError;
+};
+export type PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostError = PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostErrors[keyof PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostErrors];
+export type PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostResponses = {
+    /**
+     * Successful Response
+     */
+    200: MediaAssetPrepareUploadResponse;
+};
+export type PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostResponse = PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostResponses[keyof PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostResponses];
+export type GetOperationMarbleV1OperationsOperationIdGetData = {
+    body?: never;
+    path: {
+        /**
+         * Operation Id
+         */
+        operation_id: string;
+    };
+    query?: never;
+    url: '/marble/v1/operations/{operation_id}';
+};
+export type GetOperationMarbleV1OperationsOperationIdGetErrors = {
+    /**
+     * Validation Error
+     */
+    422: HttpValidationError;
+};
+export type GetOperationMarbleV1OperationsOperationIdGetError = GetOperationMarbleV1OperationsOperationIdGetErrors[keyof GetOperationMarbleV1OperationsOperationIdGetErrors];
+export type GetOperationMarbleV1OperationsOperationIdGetResponses = {
+    /**
+     * Successful Response
+     */
+    200: GetOperationResponseUnionWorldPanoDepthToRgbResultExportWorldResult;
+};
+export type GetOperationMarbleV1OperationsOperationIdGetResponse = GetOperationMarbleV1OperationsOperationIdGetResponses[keyof GetOperationMarbleV1OperationsOperationIdGetResponses];
+export type PanoDepthToRgbMarbleV1PanoDepthToRgbPostData = {
+    body: PanoDepthToRgbRequest;
+    path?: never;
+    query?: never;
+    url: '/marble/v1/pano:depth_to_rgb';
+};
+export type PanoDepthToRgbMarbleV1PanoDepthToRgbPostErrors = {
+    /**
+     * The account has insufficient API credits for this request.
+     */
+    402: unknown;
+    /**
+     * Validation Error
+     */
+    422: HttpValidationError;
+};
+export type PanoDepthToRgbMarbleV1PanoDepthToRgbPostError = PanoDepthToRgbMarbleV1PanoDepthToRgbPostErrors[keyof PanoDepthToRgbMarbleV1PanoDepthToRgbPostErrors];
+export type PanoDepthToRgbMarbleV1PanoDepthToRgbPostResponses = {
+    /**
+     * Successful Response
+     */
+    200: OperationPanoDepthToRgbResult;
+};
+export type PanoDepthToRgbMarbleV1PanoDepthToRgbPostResponse = PanoDepthToRgbMarbleV1PanoDepthToRgbPostResponses[keyof PanoDepthToRgbMarbleV1PanoDepthToRgbPostResponses];
+export type DeleteWorldMarbleV1WorldsWorldIdDeleteData = {
+    body?: never;
+    path: {
+        /**
+         * World Id
+         */
+        world_id: string;
+    };
+    query?: never;
+    url: '/marble/v1/worlds/{world_id}';
+};
+export type DeleteWorldMarbleV1WorldsWorldIdDeleteErrors = {
+    /**
+     * Validation Error
+     */
+    422: HttpValidationError;
+};
+export type DeleteWorldMarbleV1WorldsWorldIdDeleteError = DeleteWorldMarbleV1WorldsWorldIdDeleteErrors[keyof DeleteWorldMarbleV1WorldsWorldIdDeleteErrors];
+export type DeleteWorldMarbleV1WorldsWorldIdDeleteResponses = {
+    /**
+     * Successful Response
+     */
+    200: DeleteWorldResponse;
+};
+export type DeleteWorldMarbleV1WorldsWorldIdDeleteResponse = DeleteWorldMarbleV1WorldsWorldIdDeleteResponses[keyof DeleteWorldMarbleV1WorldsWorldIdDeleteResponses];
+export type GetWorldMarbleV1WorldsWorldIdGetData = {
+    body?: never;
+    path: {
+        /**
+         * World Id
+         */
+        world_id: string;
+    };
+    query?: never;
+    url: '/marble/v1/worlds/{world_id}';
+};
+export type GetWorldMarbleV1WorldsWorldIdGetErrors = {
+    /**
+     * Validation Error
+     */
+    422: HttpValidationError;
+};
+export type GetWorldMarbleV1WorldsWorldIdGetError = GetWorldMarbleV1WorldsWorldIdGetErrors[keyof GetWorldMarbleV1WorldsWorldIdGetErrors];
+export type GetWorldMarbleV1WorldsWorldIdGetResponses = {
+    /**
+     * Successful Response
+     */
+    200: World;
+};
+export type GetWorldMarbleV1WorldsWorldIdGetResponse = GetWorldMarbleV1WorldsWorldIdGetResponses[keyof GetWorldMarbleV1WorldsWorldIdGetResponses];
+export type ExportWorldMarbleV1WorldsWorldIdExportPostData = {
+    body: ExportWorldRequest;
+    path: {
+        /**
+         * World Id
+         */
+        world_id: string;
+    };
+    query?: never;
+    url: '/marble/v1/worlds/{world_id}:export';
+};
+export type ExportWorldMarbleV1WorldsWorldIdExportPostErrors = {
+    /**
+     * The account has insufficient API credits for this request.
+     */
+    402: unknown;
+    /**
+     * Validation Error
+     */
+    422: HttpValidationError;
+};
+export type ExportWorldMarbleV1WorldsWorldIdExportPostError = ExportWorldMarbleV1WorldsWorldIdExportPostErrors[keyof ExportWorldMarbleV1WorldsWorldIdExportPostErrors];
+export type ExportWorldMarbleV1WorldsWorldIdExportPostResponses = {
+    /**
+     * Successful Response
+     */
+    200: ExportWorldResponse;
+};
+export type ExportWorldMarbleV1WorldsWorldIdExportPostResponse = ExportWorldMarbleV1WorldsWorldIdExportPostResponses[keyof ExportWorldMarbleV1WorldsWorldIdExportPostResponses];
+export type GenerateWorldMarbleV1WorldsGeneratePostData = {
+    body: WorldsGenerateRequest;
+    path?: never;
+    query?: never;
+    url: '/marble/v1/worlds:generate';
+};
+export type GenerateWorldMarbleV1WorldsGeneratePostErrors = {
+    /**
+     * The account has insufficient API credits for this request.
+     */
+    402: unknown;
+    /**
+     * Validation Error
+     */
+    422: HttpValidationError;
+};
+export type GenerateWorldMarbleV1WorldsGeneratePostError = GenerateWorldMarbleV1WorldsGeneratePostErrors[keyof GenerateWorldMarbleV1WorldsGeneratePostErrors];
+export type GenerateWorldMarbleV1WorldsGeneratePostResponses = {
+    /**
+     * Successful Response
+     */
+    200: GenerateWorldResponse;
+};
+export type GenerateWorldMarbleV1WorldsGeneratePostResponse = GenerateWorldMarbleV1WorldsGeneratePostResponses[keyof GenerateWorldMarbleV1WorldsGeneratePostResponses];
+export type ListWorldsMarbleV1WorldsListPostData = {
+    body: ListWorldsRequest;
+    path?: never;
+    query?: never;
+    url: '/marble/v1/worlds:list';
+};
+export type ListWorldsMarbleV1WorldsListPostErrors = {
+    /**
+     * Validation Error
+     */
+    422: HttpValidationError;
+};
+export type ListWorldsMarbleV1WorldsListPostError = ListWorldsMarbleV1WorldsListPostErrors[keyof ListWorldsMarbleV1WorldsListPostErrors];
+export type ListWorldsMarbleV1WorldsListPostResponses = {
+    /**
+     * Successful Response
+     */
+    200: ListWorldsResponse;
+};
+export type ListWorldsMarbleV1WorldsListPostResponse = ListWorldsMarbleV1WorldsListPostResponses[keyof ListWorldsMarbleV1WorldsListPostResponses];