Public API and SDK for Python and JavaScript
Embed image and video generation into your product: the REST API at api.clipia.ai/v1 plus ready-made SDKs.
Clipia Public API is a REST interface at api.clipia.ai/v1 with official SDKs for JavaScript/TypeScript and Python that lets you run image and video generation straight from your code. A single HTTP request with a Bearer key returns the finished file, the task status and the exact cost in credits — no browser, no copying links, no manual steps.
What it gives you
- Generation from code: send a prompt and parameters to any of 50+ models and receive images or video programmatically — for bots, services, plugins and content automation.
- Status and cost estimation: poll task state in real time and learn exactly how many credits a run will cost before you start it, so you can plan spending.
- Balance and model catalog: check your remaining credits and pull the up-to-date list of available models with their parameters and prices in a single call.
- Official SDKs: the
clipia-ainpm package for JavaScript/TypeScript and theclipiaPyPI package for Python — with types, autocompletion and ready-made request examples.
How to start
Create an API key in the Developer Console, install the SDK with npm i clipia-ai or pip install clipia, and send your first request with Bearer authentication. Full coverage of endpoints, model parameters, response formats and error codes lives in the documentation with examples in several languages. For safe retries, pass an Idempotency-Key header so the same task is never started or charged twice.
Who it is for
The API fits developers embedding generation into their products: Telegram bots, SaaS services, plugins, content automation pipelines and batch processing. Request idempotency protects against double charges on retries, while a consistent response format and predictable error codes keep integrations reliable and resilient to network failures.
FAQ
How does authentication work? Via a Bearer API key: the key is created in the Developer Console and passed in the header of every request. One account can hold several keys with separate usage stats.
How many models are available via the API? More than 50 image and video generation models — the same catalog as on the site, from photos to video of different lengths and aspect ratios, reachable with a single request to the models endpoint.
What happens when credits run out? A clear error code with the reason — insufficient credits or an active subscription required — so your app can handle the case gracefully and prompt the user on what to do next.
