Developer docs

Integrate vdowrx into your pipeline.

Submit jobs, poll for status, receive webhooks, and deliver outputs — all via a simple REST API.

Reframing
ReasoningComing soon

Quickstart

Submit your first job

You'll need an API key from your account settings. API access requires Pro or above.

curlPythonNode.js
# 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.mp4

Authentication

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

POST/jobs
GET/jobs
GET/jobs/{id}
POST/jobs/{id}/confirm
DELETE/jobs/{id}
GET/account/usage
GET/presets

Webhooks

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.