Skip to main content
POST
/
marble
/
v1
/
pano:depth_to_rgb
Pano Depth To Rgb
curl --request POST \
  --url https://api.worldlabs.ai/marble/v1/pano:depth_to_rgb \
  --header 'Content-Type: application/json' \
  --header 'WLT-Api-Key: <api-key>' \
  --data '
{
  "depth_pano_image": {
    "media_asset_id": "<string>",
    "source": "media_asset"
  },
  "text_prompt": "<string>",
  "seed": 2147483647,
  "z_max": 1,
  "z_min": 1
}
'
{
  "done": true,
  "operation_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "error": {
    "code": 123,
    "message": "<string>"
  },
  "expires_at": "2023-11-07T05:31:56Z",
  "metadata": {},
  "response": {
    "pano_url": "<string>"
  },
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
WLT-Api-Key
string
header
required

API key for authentication. Get your key from the developer portal.

Body

application/json

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 back into metric depth.

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.

​
depth_pano_image
MediaAssetReference · object
required

Reference to a previously uploaded MediaAsset.

​
text_prompt
string
required

Text description of the desired appearance.

​
seed
integer | null

Random seed for reproducible generation.

Required range: 0 <= x <= 4294967295
​
z_max
number | null

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.

Required range: x > 0
​
z_min
number | null

Minimum depth. Required for PNG depth maps (normalized to [0, 1]). Must be provided together with z_max. Omit for EXR depth maps.

Required range: x > 0

Response

Successful Response

​
done
boolean
required

True if the operation is completed

​
operation_id
string
required

Operation identifier

​
created_at
string<date-time> | null

Creation timestamp

​
error
OperationError · object

Error information if the operation failed

​
expires_at
string<date-time> | null

Expiration timestamp

​
metadata
Metadata · object

Service-specific metadata, such as progress percentage

​
response
PanoDepthToRgbResult · object

Result payload when done=true and no error. Structure depends on operation type.

​
updated_at
string<date-time> | null

Last update timestamp