Translation Commands

Translate CAD📐CADSoftware for creating technical drawings and 3D models.View in glossary files to various formats using the Model Derivative API🔄Model DerivativeAPS service for translating and extracting CAD data.View in glossary.

Commands Overview

Supported Formats

Input Formats

RAPS🌼RAPSRust CLI for Autodesk Platform Services.View in glossary supports all APS☁️APSAutodesk Platform Services - cloud APIs for CAD/BIM automation.View in glossary-compatible input formats:

• Autodesk: RVT📊RVTRevit's native file format.View in glossary, DWG📄DWGAutoCAD's native file format.View in glossary, DWF, NWD👁️NWDNavisworks review file format.View in glossary, NWC, DGN
• Industry: IFC🌐IFCOpen standard for BIM data exchange.View in glossary, STEP🔧STEPISO standard for 3D CAD data exchange.View in glossary, IGES📜IGESLegacy neutral CAD exchange format.View in glossary, SAT
• 3D: OBJ🎲OBJSimple 3D geometry format.View in glossary, STL🖨️STL3D printing mesh format.View in glossary, 3DS, FBX🎬FBXAutodesk's 3D animation exchange format.View in glossary, GLTF
• And more…

Output Formats

raps translate start

Start a translation job for an uploaded file.

raps translate start <urn> --format <format> [options]

Options:

• --format, -f: Output format (required)
• --wait, -w: Wait for completion
• --root-filename: Root file for ZIP archives
• --force: Force re-translation

Basic translation:

$ raps translate start dXJuOmFkc2sub2JqZWN0cy... --format svf2
✓ Translation started
  URN: dXJuOmFkc2sub2JqZWN0cy...
  Status: pending

Wait for completion:

$ raps translate start $URN --format svf2 --wait
Translation in progress...
  ████████████████████████████████████████ 100%
✓ Translation complete (47s)

Multiple formats:

raps translate start $URN --format svf2
raps translate start $URN --format obj
raps translate start $URN --format thumbnail

raps translate status

Check the status of a translation job.

$ raps translate status $URN
Translation Status:
  URN: dXJuOmFkc2sub2JqZWN0cy...
  Status: success
  Progress: 100%
  
  Derivatives:
    • svf2 (3D views, 2D sheets)
    • thumbnail (256x256)

Wait for completion:

$ raps translate status $URN --wait
Waiting for translation...
████████████████████████████████████████ 100%
✓ Translation complete!

JSON📋JSONStandard data interchange format.View in glossary output for scripting:

raps translate status $URN --output json | jq '.status'

raps translate manifest

View the full translation manifest with all derivatives.

$ raps translate manifest $URN
Manifest for: dXJuOmFkc2sub2JqZWN0cy...
Status: success

Derivatives:
┌─────────────┬────────────────────────┬────────────┐
│ Type        │ Role                   │ Status     │
├─────────────┼────────────────────────┼────────────┤
│ svf2        │ 3d                     │ success    │
│ svf2        │ 2d                     │ success    │
│ thumbnail   │ thumbnail              │ success    │
└─────────────┴────────────────────────┴────────────┘

raps translate download

Download derivative📤DerivativeAny output generated from model translation.View in glossary files (OBJ, STL, STEP, etc.).

raps translate download <urn> --output <directory>

$ raps translate download $URN --output ./derivatives/
Downloading derivatives...
  [1/3] model.obj ████████████████████ 100%
  [2/3] model.mtl ████████████████████ 100%
  [3/3] textures.zip ████████████████████ 100%
✓ Downloaded to: ./derivatives/

Complete Workflow

Upload and Translate

# 1. Create a bucket
raps bucket create --key my-project --policy persistent --region US

# 2. Upload a file
raps object upload my-project building.rvt

# 3. Get the URN
URN=$(raps object urn my-project building.rvt --output plain)

# 4. Start translation
raps translate start "$URN" --format svf2 --wait

# 5. Check manifest
raps translate manifest "$URN"

Batch Translation Pipeline

for file in ./models/*.dwg; do
  name=$(basename "$file")
  raps object upload my-bucket "$file"
  URN=$(raps object urn my-bucket "$name" --output plain)
  raps translate start "$URN" --format svf2
  echo "Started translation for $name"
done

Translation Presets

Use presets for common workflows:

# High-quality for presentation
raps translate start $URN --format svf2 --preset high-quality

# Fast preview
raps translate start $URN --format svf2 --preset fast

Troubleshooting

”Translation failed” error

1. Check the manifest for detailed error messages:

   raps translate manifest $URN --output json

2. Verify the source file is valid
3. Check file format is supported

”Derivative not found” error

1. Ensure translation completed successfully
2. Check the manifest for available derivatives
3. Wait for translation to complete using --wait

Next Steps

• Data Management — Work with BIM 360🔵BIM 360Legacy Autodesk construction platform (predecessor to ACC).View in glossary/ACC🏗️ACCAutodesk's construction management platform.View in glossary projects
• Design Automation — Automate CAD processing