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 images and videos across 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.
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.