Reality Capture Commands

Create photoscenes, upload photos, and process them into 3D models using the APS☁️APSAutodesk Platform Services - cloud APIs for CAD/BIM automation.View in glossary Reality Capture API🔌APIInterface for software components to communicate.View in glossary.

Note: Reality Capture commands require 2-legged OAuth🤖2-legged authServer-to-server authentication without user context.View in glossary. Run raps auth test to verify credentials.

Commands Overview

raps reality create

Create a new photoscene for processing.

raps reality create [OPTIONS]

Options:

• -n, --name <NAME> — Photoscene name
• -s, --scene-type <TYPE> — Scene type: aerial or object
• -f, --format <FORMAT> — Output format: rcm, rcs, obj, fbx, ortho

Example:

$ raps reality create -n "Foundation Survey" -f obj
$ raps reality create -n "Site Aerial" -s aerial -f rcm

raps reality upload

Upload photos to an existing photoscene.

raps reality upload <PHOTOSCENE_ID> <FILE>...

Example:

$ raps reality upload abc123 ./photos/photo1.jpg ./photos/photo2.jpg

raps reality process

Start processing a photoscene after uploading all photos.

raps reality process <PHOTOSCENE_ID>

raps reality status

Check the processing progress of a photoscene.

raps reality status <PHOTOSCENE_ID>

raps reality result

Get the download link for processed results.

raps reality result <PHOTOSCENE_ID>

raps reality formats

List all available output formats.

raps reality formats

raps reality delete

Delete a photoscene and its data.

raps reality delete <PHOTOSCENE_ID> [--yes]

Typical Workflow

# 1. List available output formats
raps reality formats

# 2. Create a photoscene
raps reality create -n "Foundation Survey" -f obj

# 3. Upload photos
raps reality upload <photoscene-id> ./photos/*.jpg

# 4. Start processing
raps reality process <photoscene-id>

# 5. Check status (poll until complete)
raps reality status <photoscene-id>

# 6. Download result
raps reality result <photoscene-id>

# 7. Clean up
raps reality delete <photoscene-id> --yes

Next Steps

• Bucket Commands — Store processed output files
• Data Management — Upload results to BIM 360🔵BIM 360Legacy Autodesk construction platform (predecessor to ACC).View in glossary/ACC🏗️ACCAutodesk's construction management platform.View in glossary
• Translation — Convert models to viewable🖥️ViewableTranslated model output for web viewing.View in glossary formats