API and Webhooks
For developers. Create videos from your own systems, track them with webhooks and manage keys safely.
The API lets your own software create videos, check on them and download them. It is included with the Enterprise plan. On other plans, the Settings page explains what the API does and offers an upgrade.
Keys
Open Settings to find your keys.
- Account key. Your main key. You can rotate it, and the old one stops working immediately.
- Scoped keys. Create a key that can only do what you tick, for example create videos, read job status, download finished videos, read post status, schedule posts or manage webhooks. A key's secret is shown once when you create it, so save it. You can revoke a key at any time.
Rotating a key, or creating one, asks you to confirm it's you first. See Sessions and security.
Try it safely first
Send a request with "dry_run": true to find out whether a render would be accepted. A dry run creates no video and uses nothing from your allowance. It also reports your remaining allowance and a cost estimate.
curl https://api.aireelengine.com/v1/renders \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"module": "review_video", "dry_run": true, "payload": {"client_name": "Nadia Hair Studio", "review_text": "Best haircut I have had in years!", "star_rating": 5}}'Never be billed twice
Add an Idempotency-Key header to a render request. If you send the same key and the same request again, you get the original result back and no second video is made. Keys are kept for 24 hours.
Webhooks
Videos take minutes, not seconds, so instead of checking again and again you can register a webhook. We then call your URL when something happens.
Events you can subscribe to:
render.completedrender.failedpost.publishedpost.failed
Every delivery is signed, and carries a timestamp so old copies can be rejected. The secret for checking the signature is shown once when you create the webhook.
If your endpoint is down, we retry with a growing delay, up to six times over about ten hours. After that the delivery is kept, marked as failed, and you can send it again once your endpoint is healthy. A URL that points at a private or internal address is refused.
Where to read more
Settings links to the full API reference, with every request and field.
Still need help?
Our team answers around the clock, every day.
© 2026 Quantum AI WebApps Digital LLC · aireelengine.com
