Integrate vdowrx into your pipeline.
Submit jobs, poll for status, receive webhooks, and deliver outputs — all via a simple REST API.
Quickstart
Submit your first job in 5 minutes
Authentication
API keys, live vs test mode
Webhooks
Real-time job notifications
API reference
All endpoints and responses
Quickstart
Submit your first job
You'll need an API key from your account settings. API access requires Pro or above.
# 1. Submit a job
curl -X POST https://d2grp900pnwc70.cloudfront.net/api/jobs \
-H "X-Api-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input_url":"https://example.com/source.mp4","ratios":["9:16"],"preset":"podcast"}'
# 2. Poll until status = "succeeded"
curl https://d2grp900pnwc70.cloudfront.net/api/jobs/JOB_ID \
-H "X-Api-Key: YOUR_API_KEY"
# 3. Download from outputs[0].url (presigned S3, 24h validity)
curl "$DOWNLOAD_URL" -o output-9x16.mp4Authentication
API keys
Every request must include your API key in the X-Api-Key header. Keys are prefixed by mode — never commit live keys to source control.
rfrm_live_…
Live key — real jobs, billed against your plan
rfrm_test_…
Test key — same API, no billing, sandbox outputs
Key scope
Account-scoped — full access to your account's resources
Rotate freely
Revoke and re-issue from Account → API Keys at any time
API reference
Core endpoints
Base URL: https://d2grp900pnwc70.cloudfront.net/api
/jobs/jobs/jobs/{id}/jobs/{id}/confirm/jobs/{id}/account/usage/presetsWebhooks
Real-time notifications
Register an HTTPS endpoint in your dashboard. vdowrx sends a signed POST request on each event. Verify the X-Vdowrx-Signature header with your endpoint secret.
job.completed
Job succeeded — outputs are ready for download or have been pushed to your destination bucket.
job.failed
Job failed. The error field contains the failure reason and the pipeline stage where it occurred.
job.quality_flagged
Job delivered but below quality thresholds. Check quality_flags for face_retention_rate, sharpness_ratio, and subject_continuity_rate.
Ready to integrate?
Create an account, generate your API key, and submit your first job in minutes.