@tanstack/ai-worldlabs 0.0.0 → 0.1.0

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

@@ -0,0 +1,275 @@
+import { Client, ClientMeta, Options as Options2, RequestResult, TDataShape } from './client.js';
+import { DeleteWorldMarbleV1WorldsWorldIdDeleteData, DeleteWorldMarbleV1WorldsWorldIdDeleteErrors, DeleteWorldMarbleV1WorldsWorldIdDeleteResponses, ExportWorldMarbleV1WorldsWorldIdExportPostData, ExportWorldMarbleV1WorldsWorldIdExportPostErrors, ExportWorldMarbleV1WorldsWorldIdExportPostResponses, GenerateWorldMarbleV1WorldsGeneratePostData, GenerateWorldMarbleV1WorldsGeneratePostErrors, GenerateWorldMarbleV1WorldsGeneratePostResponses, GetCreditsMarbleV1CreditsGetData, GetCreditsMarbleV1CreditsGetResponses, GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetData, GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetErrors, GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetResponses, GetOperationMarbleV1OperationsOperationIdGetData, GetOperationMarbleV1OperationsOperationIdGetErrors, GetOperationMarbleV1OperationsOperationIdGetResponses, GetWorldMarbleV1WorldsWorldIdGetData, GetWorldMarbleV1WorldsWorldIdGetErrors, GetWorldMarbleV1WorldsWorldIdGetResponses, ListWorldsMarbleV1WorldsListPostData, ListWorldsMarbleV1WorldsListPostErrors, ListWorldsMarbleV1WorldsListPostResponses, PanoDepthToRgbMarbleV1PanoDepthToRgbPostData, PanoDepthToRgbMarbleV1PanoDepthToRgbPostErrors, PanoDepthToRgbMarbleV1PanoDepthToRgbPostResponses, PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostData, PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostErrors, PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostResponses } from './types.gen';
+export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options2<TData, ThrowOnError, TResponse> & {
+    /**
+     * You can provide a client instance returned by `createClient()` instead of
+     * individual options. This might be also useful if you want to implement a
+     * custom client.
+     */
+    client?: Client;
+    /**
+     * You can pass arbitrary values through the `meta` object. This can be
+     * used to access values that aren't defined as part of the SDK function.
+     */
+    meta?: keyof ClientMeta extends never ? Record<string, unknown> : ClientMeta;
+};
+/**
+ * Get Credits
+ *
+ * Get remaining API credits for the authenticated user.
+ *
+ * Returns:
+ * CreditsResponse with the current aggregate API credit balance.
+ *
+ * Raises:
+ * HTTPException: 404 if the caller is not an API-enabled user
+ * HTTPException: 503 if the billing backend is unavailable
+ */
+export declare const getCreditsMarbleV1CreditsGet: <ThrowOnError extends boolean = false>(options?: Options<GetCreditsMarbleV1CreditsGetData, ThrowOnError>) => RequestResult<GetCreditsMarbleV1CreditsGetResponses, unknown, ThrowOnError>;
+/**
+ * Get Media Asset
+ *
+ * Get a media asset by ID.
+ *
+ * Retrieves metadata for a previously created media asset.
+ *
+ * Args:
+ * media_asset_id: The media asset identifier.
+ *
+ * Returns:
+ * MediaAsset object with media_asset_id, file_name, extension, kind,
+ * metadata, created_at, and updated_at.
+ *
+ * Raises:
+ * HTTPException: 404 if not found
+ */
+export declare const getMediaAssetMarbleV1MediaAssetsMediaAssetIdGet: <ThrowOnError extends boolean = false>(options: Options<GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetData, ThrowOnError>) => RequestResult<GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetResponses, GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetErrors, ThrowOnError>;
+/**
+ * Prepare a media asset upload
+ *
+ * Prepare a media asset upload for use in world generation.
+ *
+ * This API endpoint creates a media asset record and returns a signed upload URL.
+ * Use this workflow to upload images or videos that you want to reference in world
+ * generation requests.
+ *
+ * ## Workflow
+ *
+ * 1. **Prepare Upload** (this endpoint): Get a `media_asset_id` and `upload_url`
+ * 2. **Upload File**: Use the signed URL to upload your file
+ * 3. **Generate World**: Reference the `media_asset_id` in `/worlds:generate` with
+ * source type "media_asset"
+ *
+ * ## Request Parameters
+ *
+ * - `file_name`: Your file's name (e.g., "landscape.jpg")
+ * - `extension`: File extension without dot (e.g., "jpg", "png", "mp4")
+ * - `kind`: Either "image" or "video"
+ * - `metadata`: Optional custom metadata object
+ *
+ * ## Response
+ *
+ * Returns a `MediaAssetPrepareUploadResponse` containing:
+ *
+ * - `media_asset`: Object with `media_asset_id` (use this in world generation)
+ * - `upload_info`: Object with `upload_url`, `required_headers`, and `curl_example`
+ *
+ * ## Uploading Your File
+ *
+ * Use the returned `upload_url` and `required_headers` to upload your file:
+ *
+ * ```bash
+ * curl --request PUT \
+ * --url <upload_url> \
+ * --header "Content-Type: <content-type>" \
+ * --header "<header-name>: <header-value>" \
+ * --upload-file /path/to/your/file
+ * ```
+ *
+ * Replace:
+ * - `<upload_url>`: The `upload_url` from the response
+ * - `<content-type>`: MIME type (e.g., `image/png`, `image/jpeg`, `video/mp4`)
+ * - `<header-name>: <header-value>`: Each header from `required_headers`
+ * - `/path/to/your/file`: Path to your local file
+ *
+ * ## Example Usage in World Generation
+ *
+ * After uploading, use the `media_asset_id` in a world generation request:
+ *
+ * ```json
+ * {
+ * "world_prompt": {
+ * "type": "image",
+ * "image_prompt": {
+ * "source": "media_asset",
+ * "media_asset_id": "<your-media-asset-id>"
+ * }
+ * }
+ * }
+ * ```
+ */
+export declare const prepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPost: <ThrowOnError extends boolean = false>(options: Options<PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostData, ThrowOnError>) => RequestResult<PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostResponses, PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostErrors, ThrowOnError>;
+/**
+ * Get Operation
+ *
+ * Get an operation by ID.
+ *
+ * Poll this endpoint to check the status of a long-running operation.
+ * When done=true, the response field contains the generated world.
+ *
+ * Args:
+ * operation_id: The operation identifier from /worlds:generate.
+ *
+ * Returns:
+ * GetOperationResponse[World] with:
+ * - operation_id: Operation identifier
+ * - created_at: Creation timestamp
+ * - updated_at: Last update timestamp
+ * - expires_at: Expiration timestamp
+ * - done: true when complete, false while in progress
+ * - error: Error details if failed, null otherwise
+ * - metadata: Progress information and world_id
+ * - response: Generated World if done=true, null otherwise
+ * - cost: Settled credit cost breakdown; populated only when the
+ * operation completed successfully (done=true with no error)
+ * and a public price is known for its operation type. Failed
+ * or in-progress operations return null.
+ *
+ * Raises:
+ * HTTPException: 401 if unauthorized
+ * HTTPException: 404 if operation not found
+ * HTTPException: 500 if request fails
+ */
+export declare const getOperationMarbleV1OperationsOperationIdGet: <ThrowOnError extends boolean = false>(options: Options<GetOperationMarbleV1OperationsOperationIdGetData, ThrowOnError>) => RequestResult<GetOperationMarbleV1OperationsOperationIdGetResponses, GetOperationMarbleV1OperationsOperationIdGetErrors, ThrowOnError>;
+/**
+ * Pano Depth To Rgb
+ *
+ * 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 match 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).
+ *
+ * Returns a long-running ``Operation``. Poll
+ * ``GET /operations/{operation_id}`` until
+ * ``done`` is ``true``, then read the generated
+ * panorama URL from ``response.pano_url``.
+ *
+ * Raises:
+ * HTTPException: 400 if invalid request
+ * HTTPException: 402 if insufficient credits
+ * HTTPException: 500 if generation could not start
+ */
+export declare const panoDepthToRgbMarbleV1PanoDepthToRgbPost: <ThrowOnError extends boolean = false>(options: Options<PanoDepthToRgbMarbleV1PanoDepthToRgbPostData, ThrowOnError>) => RequestResult<PanoDepthToRgbMarbleV1PanoDepthToRgbPostResponses, PanoDepthToRgbMarbleV1PanoDepthToRgbPostErrors, ThrowOnError>;
+/**
+ * Delete World
+ *
+ * Delete a world by ID.
+ *
+ * Permanently deletes a world and its associated assets.
+ * Only the world owner can delete a world.
+ *
+ * Args:
+ * world_id: The unique identifier of the world to delete.
+ *
+ * Returns:
+ * DeleteWorldResponse confirming the deletion.
+ *
+ * Raises:
+ * HTTPException: 403 if user is not the world owner
+ * HTTPException: 404 if world not found
+ * HTTPException: 500 if deletion fails
+ */
+export declare const deleteWorldMarbleV1WorldsWorldIdDelete: <ThrowOnError extends boolean = false>(options: Options<DeleteWorldMarbleV1WorldsWorldIdDeleteData, ThrowOnError>) => RequestResult<DeleteWorldMarbleV1WorldsWorldIdDeleteResponses, DeleteWorldMarbleV1WorldsWorldIdDeleteErrors, ThrowOnError>;
+/**
+ * Get World
+ *
+ * Get a world by ID.
+ *
+ * Retrieves a world's details including generated assets if available.
+ * Only the world owner or users with access to public worlds can retrieve them.
+ *
+ * Args:
+ * world_id: The unique identifier of the world.
+ *
+ * Returns:
+ * World object with world_id, display_name, tags, assets, created_at,
+ * updated_at, permission, model, world_prompt, and world_marble_url.
+ *
+ * Raises:
+ * HTTPException: 404 if world not found or access denied
+ */
+export declare const getWorldMarbleV1WorldsWorldIdGet: <ThrowOnError extends boolean = false>(options: Options<GetWorldMarbleV1WorldsWorldIdGetData, ThrowOnError>) => RequestResult<GetWorldMarbleV1WorldsWorldIdGetResponses, GetWorldMarbleV1WorldsWorldIdGetErrors, ThrowOnError>;
+/**
+ * Export World
+ *
+ * Export a generated world asset.
+ *
+ * PLY splat exports are converted synchronously, cached in GCS, and returned
+ * as completed operations. HQ mesh exports reuse the existing async mesh
+ * export service and return an in-progress operation.
+ */
+export declare const exportWorldMarbleV1WorldsWorldIdExportPost: <ThrowOnError extends boolean = false>(options: Options<ExportWorldMarbleV1WorldsWorldIdExportPostData, ThrowOnError>) => RequestResult<ExportWorldMarbleV1WorldsWorldIdExportPostResponses, ExportWorldMarbleV1WorldsWorldIdExportPostErrors, ThrowOnError>;
+/**
+ * Generate World
+ *
+ * Start world generation.
+ *
+ * Creates a new world generation job and returns a long-running operation.
+ * Poll the /operations/{operation_id} endpoint to check generation status
+ * and retrieve the generated world when complete.
+ *
+ * Args:
+ * request: The world generation request containing world_prompt, display_name,
+ * tags, model, seed, and permission settings.
+ *
+ * Returns:
+ * GenerateWorldResponse with operation_id and timestamps. Use the operation_id
+ * to poll for completion.
+ *
+ * Raises:
+ * HTTPException: 400 if invalid request or content violates policies
+ * HTTPException: 402 if insufficient credits
+ * HTTPException: 500 if generation could not be started
+ */
+export declare const generateWorldMarbleV1WorldsGeneratePost: <ThrowOnError extends boolean = false>(options: Options<GenerateWorldMarbleV1WorldsGeneratePostData, ThrowOnError>) => RequestResult<GenerateWorldMarbleV1WorldsGeneratePostResponses, GenerateWorldMarbleV1WorldsGeneratePostErrors, ThrowOnError>;
+/**
+ * List Worlds
+ *
+ * List worlds with optional filters.
+ *
+ * Returns worlds created through the API with optional filtering and pagination.
+ *
+ * Args:
+ * request: List request with optional filters:
+ * - page_size: Number of results per page (default: 10)
+ * - page_token: Pagination token from previous response
+ * - status: Filter by status (e.g., "COMPLETED")
+ * - model: Filter by model name (e.g., "marble-1.0-plus")
+ * - tags: Filter by tags (matches worlds with any tag)
+ * - is_public: Filter by visibility (true=public, false=private, null=all)
+ * - created_after: Filter by creation time (after timestamp)
+ * - created_before: Filter by creation time (before timestamp)
+ * - sort_by: Sort order ("created_at" or "updated_at")
+ *
+ * Returns:
+ * ListWorldsResponse with worlds list and next_page_token for pagination.
+ *
+ * Raises:
+ * HTTPException: 400 if invalid parameters
+ * HTTPException: 500 if request fails
+ */
+export declare const listWorldsMarbleV1WorldsListPost: <ThrowOnError extends boolean = false>(options: Options<ListWorldsMarbleV1WorldsListPostData, ThrowOnError>) => RequestResult<ListWorldsMarbleV1WorldsListPostResponses, ListWorldsMarbleV1WorldsListPostErrors, ThrowOnError>;

package/dist/esm/generated/sdk.gen.js

@@ -0,0 +1,79 @@
+import { client } from "./client.gen.js";
+//#region src/generated/sdk.gen.ts
+/**
+* Get Operation
+*
+* Get an operation by ID.
+*
+* Poll this endpoint to check the status of a long-running operation.
+* When done=true, the response field contains the generated world.
+*
+* Args:
+* operation_id: The operation identifier from /worlds:generate.
+*
+* Returns:
+* GetOperationResponse[World] with:
+* - operation_id: Operation identifier
+* - created_at: Creation timestamp
+* - updated_at: Last update timestamp
+* - expires_at: Expiration timestamp
+* - done: true when complete, false while in progress
+* - error: Error details if failed, null otherwise
+* - metadata: Progress information and world_id
+* - response: Generated World if done=true, null otherwise
+* - cost: Settled credit cost breakdown; populated only when the
+* operation completed successfully (done=true with no error)
+* and a public price is known for its operation type. Failed
+* or in-progress operations return null.
+*
+* Raises:
+* HTTPException: 401 if unauthorized
+* HTTPException: 404 if operation not found
+* HTTPException: 500 if request fails
+*/
+var getOperationMarbleV1OperationsOperationIdGet = (options) => (options.client ?? client).get({
+	security: [{
+		name: "WLT-Api-Key",
+		type: "apiKey"
+	}],
+	url: "/marble/v1/operations/{operation_id}",
+	...options
+});
+/**
+* Generate World
+*
+* Start world generation.
+*
+* Creates a new world generation job and returns a long-running operation.
+* Poll the /operations/{operation_id} endpoint to check generation status
+* and retrieve the generated world when complete.
+*
+* Args:
+* request: The world generation request containing world_prompt, display_name,
+* tags, model, seed, and permission settings.
+*
+* Returns:
+* GenerateWorldResponse with operation_id and timestamps. Use the operation_id
+* to poll for completion.
+*
+* Raises:
+* HTTPException: 400 if invalid request or content violates policies
+* HTTPException: 402 if insufficient credits
+* HTTPException: 500 if generation could not be started
+*/
+var generateWorldMarbleV1WorldsGeneratePost = (options) => (options.client ?? client).post({
+	security: [{
+		name: "WLT-Api-Key",
+		type: "apiKey"
+	}],
+	url: "/marble/v1/worlds:generate",
+	...options,
+	headers: {
+		"Content-Type": "application/json",
+		...options.headers
+	}
+});
+//#endregion
+export { generateWorldMarbleV1WorldsGeneratePost, getOperationMarbleV1OperationsOperationIdGet };
+
+//# sourceMappingURL=sdk.gen.js.map

package/dist/esm/generated/sdk.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.gen.js","names":[],"sources":["../../../src/generated/sdk.gen.ts"],"sourcesContent":["// This file is auto-generated by @hey-api/openapi-ts\n\nimport type {\n  Client,\n  ClientMeta,\n  Options as Options2,\n  RequestResult,\n  TDataShape,\n} from './client'\nimport { client } from './client.gen'\nimport type {\n  DeleteWorldMarbleV1WorldsWorldIdDeleteData,\n  DeleteWorldMarbleV1WorldsWorldIdDeleteErrors,\n  DeleteWorldMarbleV1WorldsWorldIdDeleteResponses,\n  ExportWorldMarbleV1WorldsWorldIdExportPostData,\n  ExportWorldMarbleV1WorldsWorldIdExportPostErrors,\n  ExportWorldMarbleV1WorldsWorldIdExportPostResponses,\n  GenerateWorldMarbleV1WorldsGeneratePostData,\n  GenerateWorldMarbleV1WorldsGeneratePostErrors,\n  GenerateWorldMarbleV1WorldsGeneratePostResponses,\n  GetCreditsMarbleV1CreditsGetData,\n  GetCreditsMarbleV1CreditsGetResponses,\n  GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetData,\n  GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetErrors,\n  GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetResponses,\n  GetOperationMarbleV1OperationsOperationIdGetData,\n  GetOperationMarbleV1OperationsOperationIdGetErrors,\n  GetOperationMarbleV1OperationsOperationIdGetResponses,\n  GetWorldMarbleV1WorldsWorldIdGetData,\n  GetWorldMarbleV1WorldsWorldIdGetErrors,\n  GetWorldMarbleV1WorldsWorldIdGetResponses,\n  ListWorldsMarbleV1WorldsListPostData,\n  ListWorldsMarbleV1WorldsListPostErrors,\n  ListWorldsMarbleV1WorldsListPostResponses,\n  PanoDepthToRgbMarbleV1PanoDepthToRgbPostData,\n  PanoDepthToRgbMarbleV1PanoDepthToRgbPostErrors,\n  PanoDepthToRgbMarbleV1PanoDepthToRgbPostResponses,\n  PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostData,\n  PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostErrors,\n  PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostResponses,\n} from './types.gen'\n\nexport type Options<\n  TData extends TDataShape = TDataShape,\n  ThrowOnError extends boolean = boolean,\n  TResponse = unknown,\n> = Options2<TData, ThrowOnError, TResponse> & {\n  /**\n   * You can provide a client instance returned by `createClient()` instead of\n   * individual options. This might be also useful if you want to implement a\n   * custom client.\n   */\n  client?: Client\n  /**\n   * You can pass arbitrary values through the `meta` object. This can be\n   * used to access values that aren't defined as part of the SDK function.\n   */\n  meta?: keyof ClientMeta extends never ? Record<string, unknown> : ClientMeta\n}\n\n/**\n * Get Credits\n *\n * Get remaining API credits for the authenticated user.\n *\n * Returns:\n * CreditsResponse with the current aggregate API credit balance.\n *\n * Raises:\n * HTTPException: 404 if the caller is not an API-enabled user\n * HTTPException: 503 if the billing backend is unavailable\n */\nexport const getCreditsMarbleV1CreditsGet = <\n  ThrowOnError extends boolean = false,\n>(\n  options?: Options<GetCreditsMarbleV1CreditsGetData, ThrowOnError>,\n): RequestResult<\n  GetCreditsMarbleV1CreditsGetResponses,\n  unknown,\n  ThrowOnError\n> =>\n  (options?.client ?? client).get<\n    GetCreditsMarbleV1CreditsGetResponses,\n    unknown,\n    ThrowOnError\n  >({\n    security: [{ name: 'WLT-Api-Key', type: 'apiKey' }],\n    url: '/marble/v1/credits',\n    ...options,\n  })\n\n/**\n * Get Media Asset\n *\n * Get a media asset by ID.\n *\n * Retrieves metadata for a previously created media asset.\n *\n * Args:\n * media_asset_id: The media asset identifier.\n *\n * Returns:\n * MediaAsset object with media_asset_id, file_name, extension, kind,\n * metadata, created_at, and updated_at.\n *\n * Raises:\n * HTTPException: 404 if not found\n */\nexport const getMediaAssetMarbleV1MediaAssetsMediaAssetIdGet = <\n  ThrowOnError extends boolean = false,\n>(\n  options: Options<\n    GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetData,\n    ThrowOnError\n  >,\n): RequestResult<\n  GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetResponses,\n  GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetErrors,\n  ThrowOnError\n> =>\n  (options.client ?? client).get<\n    GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetResponses,\n    GetMediaAssetMarbleV1MediaAssetsMediaAssetIdGetErrors,\n    ThrowOnError\n  >({\n    security: [{ name: 'WLT-Api-Key', type: 'apiKey' }],\n    url: '/marble/v1/media-assets/{media_asset_id}',\n    ...options,\n  })\n\n/**\n * Prepare a media asset upload\n *\n * Prepare a media asset upload for use in world generation.\n *\n * This API endpoint creates a media asset record and returns a signed upload URL.\n * Use this workflow to upload images or videos that you want to reference in world\n * generation requests.\n *\n * ## Workflow\n *\n * 1. **Prepare Upload** (this endpoint): Get a `media_asset_id` and `upload_url`\n * 2. **Upload File**: Use the signed URL to upload your file\n * 3. **Generate World**: Reference the `media_asset_id` in `/worlds:generate` with\n * source type \"media_asset\"\n *\n * ## Request Parameters\n *\n * - `file_name`: Your file's name (e.g., \"landscape.jpg\")\n * - `extension`: File extension without dot (e.g., \"jpg\", \"png\", \"mp4\")\n * - `kind`: Either \"image\" or \"video\"\n * - `metadata`: Optional custom metadata object\n *\n * ## Response\n *\n * Returns a `MediaAssetPrepareUploadResponse` containing:\n *\n * - `media_asset`: Object with `media_asset_id` (use this in world generation)\n * - `upload_info`: Object with `upload_url`, `required_headers`, and `curl_example`\n *\n * ## Uploading Your File\n *\n * Use the returned `upload_url` and `required_headers` to upload your file:\n *\n * ```bash\n * curl --request PUT \\\n * --url <upload_url> \\\n * --header \"Content-Type: <content-type>\" \\\n * --header \"<header-name>: <header-value>\" \\\n * --upload-file /path/to/your/file\n * ```\n *\n * Replace:\n * - `<upload_url>`: The `upload_url` from the response\n * - `<content-type>`: MIME type (e.g., `image/png`, `image/jpeg`, `video/mp4`)\n * - `<header-name>: <header-value>`: Each header from `required_headers`\n * - `/path/to/your/file`: Path to your local file\n *\n * ## Example Usage in World Generation\n *\n * After uploading, use the `media_asset_id` in a world generation request:\n *\n * ```json\n * {\n * \"world_prompt\": {\n * \"type\": \"image\",\n * \"image_prompt\": {\n * \"source\": \"media_asset\",\n * \"media_asset_id\": \"<your-media-asset-id>\"\n * }\n * }\n * }\n * ```\n */\nexport const prepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPost = <\n  ThrowOnError extends boolean = false,\n>(\n  options: Options<\n    PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostData,\n    ThrowOnError\n  >,\n): RequestResult<\n  PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostResponses,\n  PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostErrors,\n  ThrowOnError\n> =>\n  (options.client ?? client).post<\n    PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostResponses,\n    PrepareMediaAssetUploadMarbleV1MediaAssetsPrepareUploadPostErrors,\n    ThrowOnError\n  >({\n    security: [{ name: 'WLT-Api-Key', type: 'apiKey' }],\n    url: '/marble/v1/media-assets:prepare_upload',\n    ...options,\n    headers: {\n      'Content-Type': 'application/json',\n      ...options.headers,\n    },\n  })\n\n/**\n * Get Operation\n *\n * Get an operation by ID.\n *\n * Poll this endpoint to check the status of a long-running operation.\n * When done=true, the response field contains the generated world.\n *\n * Args:\n * operation_id: The operation identifier from /worlds:generate.\n *\n * Returns:\n * GetOperationResponse[World] with:\n * - operation_id: Operation identifier\n * - created_at: Creation timestamp\n * - updated_at: Last update timestamp\n * - expires_at: Expiration timestamp\n * - done: true when complete, false while in progress\n * - error: Error details if failed, null otherwise\n * - metadata: Progress information and world_id\n * - response: Generated World if done=true, null otherwise\n * - cost: Settled credit cost breakdown; populated only when the\n * operation completed successfully (done=true with no error)\n * and a public price is known for its operation type. Failed\n * or in-progress operations return null.\n *\n * Raises:\n * HTTPException: 401 if unauthorized\n * HTTPException: 404 if operation not found\n * HTTPException: 500 if request fails\n */\nexport const getOperationMarbleV1OperationsOperationIdGet = <\n  ThrowOnError extends boolean = false,\n>(\n  options: Options<\n    GetOperationMarbleV1OperationsOperationIdGetData,\n    ThrowOnError\n  >,\n): RequestResult<\n  GetOperationMarbleV1OperationsOperationIdGetResponses,\n  GetOperationMarbleV1OperationsOperationIdGetErrors,\n  ThrowOnError\n> =>\n  (options.client ?? client).get<\n    GetOperationMarbleV1OperationsOperationIdGetResponses,\n    GetOperationMarbleV1OperationsOperationIdGetErrors,\n    ThrowOnError\n  >({\n    security: [{ name: 'WLT-Api-Key', type: 'apiKey' }],\n    url: '/marble/v1/operations/{operation_id}',\n    ...options,\n  })\n\n/**\n * Pano Depth To Rgb\n *\n * Generate an RGB panorama from a depth panorama.\n *\n * Provide a depth panorama and a text prompt\n * describing the desired appearance. The depth map\n * supplies the scene geometry; the model synthesizes\n * textures that match that geometry and returns a\n * panoramic RGB image.\n *\n * Accepted depth inputs:\n *\n * * **EXR**: float depth values. Omit\n * ``z_min`` and ``z_max``.\n * * **PNG**: depth values normalized to [0, 1].\n * Provide both ``z_min`` and ``z_max`` so the\n * service can decode the PNG correctly.\n *\n * For a complete PNG-based workflow, see the\n * [web-chisel-depth-png example](https://github.com/worldlabsai/worldlabs-api-examples/tree/main/web-chisel-depth-png).\n *\n * Returns a long-running ``Operation``. Poll\n * ``GET /operations/{operation_id}`` until\n * ``done`` is ``true``, then read the generated\n * panorama URL from ``response.pano_url``.\n *\n * Raises:\n * HTTPException: 400 if invalid request\n * HTTPException: 402 if insufficient credits\n * HTTPException: 500 if generation could not start\n */\nexport const panoDepthToRgbMarbleV1PanoDepthToRgbPost = <\n  ThrowOnError extends boolean = false,\n>(\n  options: Options<PanoDepthToRgbMarbleV1PanoDepthToRgbPostData, ThrowOnError>,\n): RequestResult<\n  PanoDepthToRgbMarbleV1PanoDepthToRgbPostResponses,\n  PanoDepthToRgbMarbleV1PanoDepthToRgbPostErrors,\n  ThrowOnError\n> =>\n  (options.client ?? client).post<\n    PanoDepthToRgbMarbleV1PanoDepthToRgbPostResponses,\n    PanoDepthToRgbMarbleV1PanoDepthToRgbPostErrors,\n    ThrowOnError\n  >({\n    security: [{ name: 'WLT-Api-Key', type: 'apiKey' }],\n    url: '/marble/v1/pano:depth_to_rgb',\n    ...options,\n    headers: {\n      'Content-Type': 'application/json',\n      ...options.headers,\n    },\n  })\n\n/**\n * Delete World\n *\n * Delete a world by ID.\n *\n * Permanently deletes a world and its associated assets.\n * Only the world owner can delete a world.\n *\n * Args:\n * world_id: The unique identifier of the world to delete.\n *\n * Returns:\n * DeleteWorldResponse confirming the deletion.\n *\n * Raises:\n * HTTPException: 403 if user is not the world owner\n * HTTPException: 404 if world not found\n * HTTPException: 500 if deletion fails\n */\nexport const deleteWorldMarbleV1WorldsWorldIdDelete = <\n  ThrowOnError extends boolean = false,\n>(\n  options: Options<DeleteWorldMarbleV1WorldsWorldIdDeleteData, ThrowOnError>,\n): RequestResult<\n  DeleteWorldMarbleV1WorldsWorldIdDeleteResponses,\n  DeleteWorldMarbleV1WorldsWorldIdDeleteErrors,\n  ThrowOnError\n> =>\n  (options.client ?? client).delete<\n    DeleteWorldMarbleV1WorldsWorldIdDeleteResponses,\n    DeleteWorldMarbleV1WorldsWorldIdDeleteErrors,\n    ThrowOnError\n  >({\n    security: [{ name: 'WLT-Api-Key', type: 'apiKey' }],\n    url: '/marble/v1/worlds/{world_id}',\n    ...options,\n  })\n\n/**\n * Get World\n *\n * Get a world by ID.\n *\n * Retrieves a world's details including generated assets if available.\n * Only the world owner or users with access to public worlds can retrieve them.\n *\n * Args:\n * world_id: The unique identifier of the world.\n *\n * Returns:\n * World object with world_id, display_name, tags, assets, created_at,\n * updated_at, permission, model, world_prompt, and world_marble_url.\n *\n * Raises:\n * HTTPException: 404 if world not found or access denied\n */\nexport const getWorldMarbleV1WorldsWorldIdGet = <\n  ThrowOnError extends boolean = false,\n>(\n  options: Options<GetWorldMarbleV1WorldsWorldIdGetData, ThrowOnError>,\n): RequestResult<\n  GetWorldMarbleV1WorldsWorldIdGetResponses,\n  GetWorldMarbleV1WorldsWorldIdGetErrors,\n  ThrowOnError\n> =>\n  (options.client ?? client).get<\n    GetWorldMarbleV1WorldsWorldIdGetResponses,\n    GetWorldMarbleV1WorldsWorldIdGetErrors,\n    ThrowOnError\n  >({\n    security: [{ name: 'WLT-Api-Key', type: 'apiKey' }],\n    url: '/marble/v1/worlds/{world_id}',\n    ...options,\n  })\n\n/**\n * Export World\n *\n * Export a generated world asset.\n *\n * PLY splat exports are converted synchronously, cached in GCS, and returned\n * as completed operations. HQ mesh exports reuse the existing async mesh\n * export service and return an in-progress operation.\n */\nexport const exportWorldMarbleV1WorldsWorldIdExportPost = <\n  ThrowOnError extends boolean = false,\n>(\n  options: Options<\n    ExportWorldMarbleV1WorldsWorldIdExportPostData,\n    ThrowOnError\n  >,\n): RequestResult<\n  ExportWorldMarbleV1WorldsWorldIdExportPostResponses,\n  ExportWorldMarbleV1WorldsWorldIdExportPostErrors,\n  ThrowOnError\n> =>\n  (options.client ?? client).post<\n    ExportWorldMarbleV1WorldsWorldIdExportPostResponses,\n    ExportWorldMarbleV1WorldsWorldIdExportPostErrors,\n    ThrowOnError\n  >({\n    security: [{ name: 'WLT-Api-Key', type: 'apiKey' }],\n    url: '/marble/v1/worlds/{world_id}:export',\n    ...options,\n    headers: {\n      'Content-Type': 'application/json',\n      ...options.headers,\n    },\n  })\n\n/**\n * Generate World\n *\n * Start world generation.\n *\n * Creates a new world generation job and returns a long-running operation.\n * Poll the /operations/{operation_id} endpoint to check generation status\n * and retrieve the generated world when complete.\n *\n * Args:\n * request: The world generation request containing world_prompt, display_name,\n * tags, model, seed, and permission settings.\n *\n * Returns:\n * GenerateWorldResponse with operation_id and timestamps. Use the operation_id\n * to poll for completion.\n *\n * Raises:\n * HTTPException: 400 if invalid request or content violates policies\n * HTTPException: 402 if insufficient credits\n * HTTPException: 500 if generation could not be started\n */\nexport const generateWorldMarbleV1WorldsGeneratePost = <\n  ThrowOnError extends boolean = false,\n>(\n  options: Options<GenerateWorldMarbleV1WorldsGeneratePostData, ThrowOnError>,\n): RequestResult<\n  GenerateWorldMarbleV1WorldsGeneratePostResponses,\n  GenerateWorldMarbleV1WorldsGeneratePostErrors,\n  ThrowOnError\n> =>\n  (options.client ?? client).post<\n    GenerateWorldMarbleV1WorldsGeneratePostResponses,\n    GenerateWorldMarbleV1WorldsGeneratePostErrors,\n    ThrowOnError\n  >({\n    security: [{ name: 'WLT-Api-Key', type: 'apiKey' }],\n    url: '/marble/v1/worlds:generate',\n    ...options,\n    headers: {\n      'Content-Type': 'application/json',\n      ...options.headers,\n    },\n  })\n\n/**\n * List Worlds\n *\n * List worlds with optional filters.\n *\n * Returns worlds created through the API with optional filtering and pagination.\n *\n * Args:\n * request: List request with optional filters:\n * - page_size: Number of results per page (default: 10)\n * - page_token: Pagination token from previous response\n * - status: Filter by status (e.g., \"COMPLETED\")\n * - model: Filter by model name (e.g., \"marble-1.0-plus\")\n * - tags: Filter by tags (matches worlds with any tag)\n * - is_public: Filter by visibility (true=public, false=private, null=all)\n * - created_after: Filter by creation time (after timestamp)\n * - created_before: Filter by creation time (before timestamp)\n * - sort_by: Sort order (\"created_at\" or \"updated_at\")\n *\n * Returns:\n * ListWorldsResponse with worlds list and next_page_token for pagination.\n *\n * Raises:\n * HTTPException: 400 if invalid parameters\n * HTTPException: 500 if request fails\n */\nexport const listWorldsMarbleV1WorldsListPost = <\n  ThrowOnError extends boolean = false,\n>(\n  options: Options<ListWorldsMarbleV1WorldsListPostData, ThrowOnError>,\n): RequestResult<\n  ListWorldsMarbleV1WorldsListPostResponses,\n  ListWorldsMarbleV1WorldsListPostErrors,\n  ThrowOnError\n> =>\n  (options.client ?? client).post<\n    ListWorldsMarbleV1WorldsListPostResponses,\n    ListWorldsMarbleV1WorldsListPostErrors,\n    ThrowOnError\n  >({\n    security: [{ name: 'WLT-Api-Key', type: 'apiKey' }],\n    url: '/marble/v1/worlds:list',\n    ...options,\n    headers: {\n      'Content-Type': 'application/json',\n      ...options.headers,\n    },\n  })\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2PA,IAAa,gDAGX,aASC,QAAQ,UAAU,OAAA,CAAQ,IAIzB;CACA,UAAU,CAAC;EAAE,MAAM;EAAe,MAAM;CAAS,CAAC;CAClD,KAAK;CACL,GAAG;AACL,CAAC;;;;;;;;;;;;;;;;;;;;;;;AA6LH,IAAa,2CAGX,aAMC,QAAQ,UAAU,OAAA,CAAQ,KAIzB;CACA,UAAU,CAAC;EAAE,MAAM;EAAe,MAAM;CAAS,CAAC;CAClD,KAAK;CACL,GAAG;CACH,SAAS;EACP,gBAAgB;EAChB,GAAG,QAAQ;CACb;AACF,CAAC"}