@tanstack/ai-worldlabs 0.0.0 → 0.1.2

package/src/generated/types.gen.ts

@@ -0,0 +1,1767 @@
+// This file is auto-generated by @hey-api/openapi-ts
+
+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]