---
title: Introduction
description: Clipia API, MCP and SDK documentation — image and video generation for developers and AI agents.
icon: House
---

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

<Cards>
  <Card title="REST API" href="/en/docs/api-reference/overview">
    An async generation queue: submit a task, poll its status, fetch the result.
  </Card>
  <Card title="Model catalog" href="/en/docs/api-reference/models">
    Every active image, video, and audio slug with live schemas and pricing.
  </Card>
  <Card title="MCP" href="/en/docs/mcp">
    Connect Clipia to Claude, ChatGPT, Cursor and other agents with a single command.
  </Card>
  <Card title="AI Gateway" href="/en/docs/llm-gateway">
    OpenAI-compatible chat: models, streaming, tools, and credit-based billing.
  </Card>
  <Card title="SDK" href="/en/docs/sdk/typescript">
    Official libraries for TypeScript (`clipia-ai`) and Python (`clipia`).
  </Card>
</Cards>

<Callout title="Sandbox">
  Test keys `clipia_test_*` never spend credits — handy for debugging your
  integration before going live.
</Callout>

## Basic flow

<Steps>
<Step>
### Get an API key

Create a key in the [developer console](/developer) — it is shown only once.
</Step>
<Step>
### Submit a generation task

Call `POST /v1/models/:model` with an `input` body. The response returns a `request_id`.
</Step>
<Step>
### Wait for completion

Via a webhook or by polling `GET /v1/requests/:id/status` until the status is `COMPLETED`.
</Step>
<Step>
### Fetch the result

Get a link to the finished image or video on the `media.clipia.ai` CDN.
</Step>
</Steps>
