---
title: "Render a USD file"
method: POST
path: "/render"
tags: ["render"]
---

# Render a USD file

`POST /render`

Accepts a USD URL and render settings, returns base64-encoded images keyed by frame, camera, and sensor.

## Request body

- RenderRequest
  - `url` string, required — URL of the USD asset (file://, http://, or s3://).
  - `force_render` boolean
  - `render_settings` RenderSettings
    - `camera_paths` string[]
    - `frame_range` FrameRange
      - `start` integer
      - `end` integer
    - `camera_parameters` CameraParameters
      - `width` integer
      - `height` integer
    - `sensors` string[], nullable
    - `apply_background_mask` boolean
    - `material_target` 'auto' | 'display_color' | 'preview_surface' | 'openpbr_materialx' | 'omnipbr_mdl', nullable — Explicit render material target. auto preserves authored/native materials; use preview_surface only to request render-export PreviewSurface fallbacks.

## Response `200`

Render succeeded (or failed — check status field)

- RenderResponse
  - `status` 'success' | 'exception'
  - `error` string, nullable
  - `images` object — Nested map: frame_number -> camera_path -> sensor_name -> base64 string.

## Changes

- **2026-07-21** `408438e48e8d` — 1 info
  - added the new optional request property `render_settings/material_target`

[Change history](https://skmtc.dev/nvidia/apis/ovrtx-rendering-api/changes/render/post.md)

---

[API](https://skmtc.dev/nvidia/apis/ovrtx-rendering-api.md) · [All operations](https://skmtc.dev/nvidia/apis/ovrtx-rendering-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nvidia/ovrtx-rendering-api/revisions/408438e48e8d/schema)