---
title: Введение
description: Документация Clipia API, MCP и SDK — генерация изображений и видео для разработчиков и AI-агентов.
icon: House
---

Clipia — это REST API, MCP-сервер и SDK для генерации изображений и видео
и аудио через 60+ AI-моделей. Один ключ, единый контракт, оплата в кредитах.

## С чего начать

<Cards>
  <Card title="REST API" href="/ru/docs/api-reference/overview">
    Асинхронная очередь генераций: отправка задачи, опрос статуса, получение результата.
  </Card>
  <Card title="Каталог моделей" href="/ru/docs/api-reference/models">
    Все активные slug моделей изображений, видео и аудио, актуальные схемы и цены.
  </Card>
  <Card title="MCP" href="/ru/docs/mcp">
    Подключение Clipia к Claude, ChatGPT, Cursor и другим агентам одной командой.
  </Card>
  <Card title="AI Gateway" href="/ru/docs/llm-gateway">
    OpenAI-совместимый чат: модели, стриминг, инструменты и оплата в кредитах.
  </Card>
  <Card title="SDK" href="/ru/docs/sdk/typescript">
    Официальные библиотеки для TypeScript (`clipia-ai`) и Python (`clipia`).
  </Card>
</Cards>

<Callout title="Песочница">
  Тестовые ключи `clipia_test_*` не списывают кредиты — удобно для отладки
  интеграции перед запуском в продакшн.
</Callout>

## Базовый поток

<Steps>
<Step>
### Получите API-ключ

Создайте ключ в [консоли разработчика](/developer) — он показывается один раз.
</Step>
<Step>
### Отправьте задачу на генерацию

Вызовите `POST /v1/models/:model` с телом `input`. В ответе придёт `request_id`.
</Step>
<Step>
### Дождитесь готовности

Через вебхук или опросом `GET /v1/requests/:id/status`, пока статус не станет `COMPLETED`.
</Step>
<Step>
### Заберите результат

Получите ссылку на готовое изображение или видео на CDN `media.clipia.ai`.
</Step>
</Steps>