Introduction
Clipia API, MCP and SDK documentation — image and video generation for developers and AI agents.
Clipia is a REST API, MCP server and SDK for generating image, video, and audio with 60+ AI models. One key, one contract, credit-based billing.
Where to start
REST API
An async generation queue: submit a task, poll its status, fetch the result.
Model catalog
Every active image, video, and audio slug with live schemas and pricing.
MCP
Connect Clipia to Claude, ChatGPT, Cursor and other agents with a single command.
AI Gateway
OpenAI-compatible chat: models, streaming, tools, and credit-based billing.
SDK
Official libraries for TypeScript (clipia-ai) and Python (clipia).
Sandbox
Test keys clipia_test_* never spend credits — handy for debugging your
integration before going live.
Basic flow
Get an API key
Create a key in the developer console — it is shown only once.
Submit a generation task
Call POST /v1/models/:model with an input body. The response returns a request_id.
Wait for completion
Via a webhook or by polling GET /v1/requests/:id/status until the status is COMPLETED.
Fetch the result
Get a link to the finished image or video on the media.clipia.ai CDN.