Integrate
A few lines to your first render
Official, fully typed clients for Python and TypeScript. Create renders, wait for results, and verify webhook signatures with helpers built in — and typed exceptions when something goes wrong.
SDKs
Typed clients for real backends
Zvid ships official SDKs so you don’t hand-roll HTTP. The Python client offers both synchronous and async interfaces built on httpx with pydantic v2 models; the TypeScript client is zero-dependency with a dual ESM/CJS build and strict types generated from the OpenAPI spec.
Both cover the full surface — renders, jobs, templates, projects, webhooks, and credits — with a wait-for-render helper that polls to completion and a timing-safe webhook-signature verifier. Errors are typed too: authentication, insufficient credits, not found, rate limit, render failed, and wait timeout each have their own class.
What you get
Batteries included
Python: sync & async
httpx-based Zvid and AsyncZvid clients with pydantic v2 models and a shipped py.typed marker.
TypeScript: zero-dep
A dual ESM/CJS build with strict types from the OpenAPI spec, sideEffects:false, for Node and modern runtimes.
Wait for render
A built-in helper polls a job to completion and returns the finished output URL.
Verify webhooks
Timing-safe signature verification is built in, so you can trust deliveries in a single call.
Typed errors
Authentication, insufficient-credits, not-found, rate-limit, render-failed, and timeout each raise a distinct typed error.
Full coverage
Renders, jobs, templates, projects, webhooks, and credits — the whole API, in idiomatic code.
Python + TS
Official SDKs
Sync & async
Python interfaces
Zero-dep
TypeScript client
Typed
Errors & models
Keep exploring
Related features
JSON Video API
Render a finished, hosted video from one authenticated POST. Send an inline JSON project or a template id and get back a job you can poll or get pinged about.
Explore →MCP Server & AI Agents
A Model Context Protocol server exposes 30 Zvid tools to any AI agent — with schema-aware authoring and a free validation step so generated JSON renders first try.
Explore →Webhooks
Skip the polling loop. Zvid calls your endpoint the moment a render completes or fails, with every delivery HMAC-signed so you can verify it came from us.
Explore →FAQ
Frequently asked questions
Which languages are supported? +
Official SDKs for Python (sync and async) and TypeScript/JavaScript, both fully typed. Any language can also call the REST API directly.
Do the SDKs help with webhooks? +
Yes. Both include a timing-safe signature verifier and typed models, so verifying and handling deliveries takes a single call.
How do I install them? +
The SDKs live in the Zvid integrations repo. Check the docs for the current install instructions and package names.
Want the full picture? See every Zvid feature
Ready to ship video at scale?
Start free — your first render is only a JSON payload away.