OPENSTRATE_RECON_API

https://openstrate.com

All paths below are rooted here. JSON bodies use Content-Type: application/json unless noted.

1. Upload a video with POST /api/upload (multipart). For .mp4, .webm, etc., the API stores the file and starts reconstruction automatically, returning a job_id.
2. Poll GET /api/reconstruct/status/{job_id} until status is complete or failed.
3. Open view_url from the job (or use GET /view/{id}.glb once you have the asset id).

If you already host the video at a public URL OpenStrate can fetch, you can skip multipart upload and call POST /api/reconstruct with video_url instead.

Multipart upload for 3D assets and video. Video uploads trigger reconstruction in the same response.

POST /api/upload
Content-Type: multipart/form-data

Allowed types include .glb, .ply, .bin, .omxl, .stl, and video: .mp4, .mov, .avi, .mkv, .webm. Max size: 500 MB.

curl -X POST https://openstrate.com/api/upload \
  -F "file=@walkthrough.mp4"

Response 200 (mesh upload — no video):

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "filename": "scene.glb",
  "url": "https://openstrate.com/api/files/a1b2c3d4-e5f6-7890-abcd-ef1234567890.glb",
  "view": "https://openstrate.com/view/a1b2c3d4-e5f6-7890-abcd-ef1234567890.glb",
  "size": 2048576
}

Response 200 (video — reconstruction started): same fields plus:

• job_id — use with status endpoint
• reconstruction_started — boolean
• reconstruction_error — present if the pipeline could not be reached (e.g. maintenance)

Start a job when the input video is already available at a downloadable HTTPS URL (e.g. the url from a prior upload).

POST /api/reconstruct
Content-Type: application/json

{
  "video_url": "https://openstrate.com/api/files/{uuid}.mp4",
  "filename": "optional-original-name.mp4"
}

Response 200

{ "job_id": "…", "status": "processing" }

Response 503 — worker unavailable; body may include job_id and error.

GET /api/reconstruct/status/{job_id}

Returns the persisted job document. Poll every few seconds while status is pending or processing.

Common fields

curl -s https://openstrate.com/api/reconstruct/status/YOUR_JOB_ID | jq .

Endpoints such as POST /api/reconstruct/progress/{job_id}, POST /api/reconstruct/complete/{job_id}, and POST /api/reconstruct/session/{job_id} are invoked by the OpenStrate reconstruction service, not by end-user apps. Integrators only need upload + status + viewer URLs above.

After reconstruction (or direct mesh upload):

• Download: GET /api/files/{id}.{ext}
• Viewer: GET /view/{id}.{ext} — WebGL viewer, orbit / zoom / pan
• Preview PNG (for link unfurls): GET /api/preview/{id}.{ext}

Upload, download, and preview error semantics match the OpenStrate file host contract (multipart field file, GET /api/files/…, GET /api/preview/…).