Video to VR Conversion API
Add AI-powered 2D-to-360° VR video conversion to your platform. Upload a standard video, get back headset-ready equirectangular VR — no 360 camera, no manual editing, and no conversion infrastructure to run yourself.
Who it's for
Built for teams shipping VR at scale
SaaS & Media Platforms
Add VR export as a feature in your video platform without building conversion infrastructure.
Real Estate & Property Tech
Turn property walkthroughs and listing videos into immersive VR tours automatically.
E-Learning Providers
Convert training and lecture footage into VR-ready content for immersive learning.
Agencies & Production Studios
White-label VR conversion for client deliverables at scale, without hiring VR specialists.
Process
How it works
Generate API Credentials
Create a Client ID and Client Secret from your BuildVR dashboard, then authenticate every request with them.
Upload & Process
Initiate an upload, push your video to the signed URL, and call Complete Upload to kick off AI-powered VR conversion.
Track & Retrieve
Poll job status through the lifecycle — pending, processing, completed — and retry automatically if a job fails.
Integration
A few lines to start a conversion
Every request is authenticated with your Client ID and Secret, then routed through a simple upload → process → poll workflow.
curl -X POST https://manage.buildvr.ai/api/client/v1/uploads/video/initiate \
-H "X-Client-ID: <YOUR_CLIENT_ID>" \
-H "X-Client-Secret: <YOUR_CLIENT_SECRET>" \
-H "Content-Type: application/json" \
-d '{
"filename": "walkthrough.mp4",
"expected_duration_sec": 120
}'Features
What you get
AI-Powered Conversion
Generate immersive 360° equirectangular VR video from standard 2D footage — no 360 camera required.
Asynchronous Processing
Large files and long-running jobs are processed off the request thread, so your app never blocks on conversion.
Secure, Signed Uploads
Every upload goes through a time-bound signed URL, scoped to your account and quota.
Full Job Lifecycle Visibility
Track every job through pending, uploading, processing, completed, or failed — and retry on demand.
Plan-Based Scaling
Start on a free tier and scale to enterprise limits — higher quotas, faster processing, dedicated infrastructure.
Cloud-Native Delivery
Processed VR video is delivered from cloud storage, ready to embed or stream directly into your product.
Pricing
Straightforward, usage-based access
API access is included on every BuildVR plan, with quotas that scale as you grow.
Limited uploads & processing quota to test the API.
Paid PlansHigher limits, faster processing, priority jobs.
EnterpriseCustom quotas & dedicated infrastructure.
Full endpoint reference, request/response schemas, and error codes are in the API docs.
FAQ
Frequently Asked Questions
What does the BuildVR Video Conversion API actually do?
The Video Conversion API lets your application upload a standard 2D video and receive back an immersive 360° equirectangular VR video, generated with AI — no 360-degree camera or manual VR editing required.
How do I authenticate requests?
Every request requires a Client ID and Client Secret, generated from your API credentials page, passed as the X-Client-ID and X-Client-Secret headers. Requests without them return a 401.
What's the upload and processing workflow?
You initiate an upload to get a signed storage URL, upload the file directly via PUT, then call Complete Upload to register it and start processing. Jobs move through pending, uploading, processing, and completed states, and can be retried if they fail.
Are there limits on video size or duration?
Yes — duration, file size, and monthly/daily upload quotas depend on your subscription plan. Free and trial plans have limited quotas; paid and enterprise plans raise those limits.
Can I use this API to power my own product for customers?
Yes. The API is built for platforms, agencies, and SaaS products that want to offer VR video conversion as a feature without building or maintaining the AI pipeline themselves.
What happens if a processing job fails?
Failed jobs can be resubmitted through the retry endpoint without re-uploading the source file. You can monitor job status at any point in the lifecycle.
Where can I find the full API reference?
The complete endpoint reference — including request/response schemas and error codes — is in the Video Processing API docs.
Ready to add VR conversion to your platform?
Get API credentials and start converting your first video in minutes.