v1

latestOpenAPI 3.1.02026-07-26104450.2 KB

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.

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

post/marble/v1/pano:depth_to_rgb

Request body

seedinteger nullable

Random seed for reproducible generation.

text_promptstring required

Text description of the desired appearance.

z_maxnumber nullable

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_minnumber nullable

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

Example request

{
  "depth_pano_image": {
    "source": "uri",
    "uri": "https://example.com/depth.exr"
  },
  "text_prompt": "The scene is a warm, rustic cabin interior with a realistic style and a cozy winter atmosphere. Wooden walls and exposed beams frame the room, while a stone fireplace casts soft amber light across simple furnishings and natural textures. The 360 scene is faultless."
}

Response

Successful Response

created_atstring date-time nullable

Creation timestamp

doneboolean required

True if the operation is completed

expires_atstring date-time nullable

Expiration timestamp

metadataobject nullable

Service-specific metadata, such as progress percentage

operation_idstring required

Operation identifier

updated_atstring date-time nullable

Last update timestamp