# Документация Clipia

> Как работать с Clipia: студии изображений, видео и аудио, выбор модели, кредиты и оплата, правила контента, REST API, MCP-сервер и SDK.

Каждая страница доступна и как Markdown: замените https://clipia.ai/ru/docs/ на https://clipia.ai/markdown/ru/docs/ в адресе. Гайд для AI-агентов: https://clipia.ai/ru/docs/mcp

- [Как работать с Clipia](https://clipia.ai/ru/docs): Clipia — AI-генерация изображений, видео и аудио на 60+ моделях: студии в браузере, ассистент, API, MCP и SDK.

## Продукт

- [Обзор Clipia](https://clipia.ai/ru/docs/product): Что такое Clipia, кому подходит и где что лежит в приложении — тренды и студии, агент, генерация фото, видео и звука, библиотека работ, тарифы и Telegram.
- [Первые шаги](https://clipia.ai/ru/docs/product/quickstart): Регистрация в Clipia, 5 приветственных кредитов, первая картинка и первое видео за несколько минут, где найти результат и куда идти дальше.
- [Тренды и студии](https://clipia.ai/ru/docs/product/studio): Где в Clipia искать идеи и где создавать — страница «Тренды» с подборкой из X, шаблонами и вашими работами, кнопка «Использовать» и студии фото, видео и звука.
- [Ассистент и агент](https://clipia.ai/ru/docs/product/assistant): Clipia Agent и Clipia Chat — чат с моделями OpenAI, Anthropic, Google и других, агент с инструментами генерации, вложения, память, экспорт ответов и лимиты.
- [Шаблоны](https://clipia.ai/ru/docs/product/templates): Как найти готовый шаблон на странице «Тренды» — подборка из X и все шаблоны, поиск и фильтры, перенос в студию кнопкой «Использовать» и свои работы как шаблон.
- [Мои работы](https://clipia.ai/ru/docs/product/my-works): Где хранятся результаты генераций в Clipia, как их искать, скачивать, раскладывать по папкам, повторять, публиковать и удалять, и сколько места даёт тариф.
- [Кредиты и тарифы](https://clipia.ai/ru/docs/product/credits): Что такое кредит, как считается и списывается цена генерации, что дают тарифы Basic, Standard, Pro и Ultima и как работают пакеты пополнения.
- [Оплата и подписка](https://clipia.ai/ru/docs/product/payments): Как оплатить подписку или пакет кредитов картой или через СБП, в какой валюте списываются деньги, как работает автопродление, отмена и возврат.
- [Аккаунт и настройки](https://clipia.ai/ru/docs/product/account): Вход по почте, через Google, Яндекс или по ключу доступа, профиль и обложка, язык, уведомления, пароль и двухфакторная защита, удаление аккаунта.
- [Партнёрская программа](https://clipia.ai/ru/docs/product/partners): Как стать партнёром Clipia, получить реферальную ссылку, какие уровни и проценты действуют, когда начисляется комиссия и как её вывести.
- [Clipia в Telegram](https://clipia.ai/ru/docs/product/telegram): Бот @clipiabot и мини-приложение Clipia в Telegram — как открыть и войти, получить приветственные кредиты, проверить и пополнить баланс, найти работы.
- [Правила контента и права на результат](https://clipia.ai/ru/docs/product/rules): Что нельзя генерировать в Clipia, как работает модерация и что происходит с кредитами при отказе, какие права на результат даёт каждый тариф.
- [Частые вопросы](https://clipia.ai/ru/docs/product/faq): Ответы на частые вопросы о Clipia — кредиты и тарифы, возвраты, оплата, качество результата, модерация, аккаунт, студии и API.

## Студии

- [Обзор студий](https://clipia.ai/ru/docs/studios): Что такое студии Clipia, какую выбрать под задачу и как в них устроены режимы, цена на кнопке, резерв кредитов, «Мои задачи» и «Мои работы».
- [Фотостудия](https://clipia.ai/ru/docs/studios/image): Фотостудия Clipia — картинки по тексту, правка и объединение фото, улучшение качества и карусели. Модели, параметры, лимиты и цены в кредитах.
- [Видеостудия](https://clipia.ai/ru/docs/studios/video): Видео по тексту и из фото, оживление и говорящее фото, правка, ролик по образцу, апскейл и моушн-контроль — режимы, модели, лимиты и цены.
- [Аудиостудия](https://clipia.ai/ru/docs/studios/audio): Аудиостудия Clipia: озвучка, музыка, расшифровка, перевод видео, субтитры, длинный текст, свой голос и очистка звука — модели, лимиты и цены в кредитах.
- [Улучшение и апскейл](https://clipia.ai/ru/docs/studios/enhance): Как повысить разрешение фото и видео в Clipia: базовый режим и режим на модели Topaz, кратность 2× и 4×, лимиты файлов и цена в кредитах.
- [Студия каруселей](https://clipia.ai/ru/docs/studios/carousel): Карусели для Instagram и других соцсетей в Clipia: план и тексты слайдов по теме, форматы, стили, палитры, макеты, редактор, экспорт и цена иллюстраций.
- [Карточки для маркетплейсов](https://clipia.ai/ru/docs/studios/marketplace): Как сделать комплект карточек товара для Wildberries и Ozon из фото с телефона — загрузка, проверка сведений, настройка карточек, стоимость и скачивание.
- [Ролик под ключ](https://clipia.ai/ru/docs/studios/video-agent): Режиссёр-ИИ превращает идею в готовый ролик — сценарий по сценам, озвучка, музыка и субтитры. Сценарий и смета без списания, сборка на платных тарифах.

## Модели

- [Как выбрать модель](https://clipia.ai/ru/docs/models): Обзор моделей Clipia для фото, видео и аудио — разработчики, как читать цену в кредитах и какую модель взять под задачу: старт, качество, текст в кадре, звук.
- [Модели изображений](https://clipia.ai/ru/docs/models/image): Все модели изображений в Clipia: разработчики, сильные стороны, форматы и разрешение, сколько фото принимают, режимы и цена в кредитах. Как выбрать модель.
- [Модели видео](https://clipia.ai/ru/docs/models/video): Паспорта видеомоделей Clipia — Veo, Kling, Seedance, Wan, HappyHorse, Hailuo, Grok и другие: режимы, длительность, качество, звук, цены и выбор по задаче.
- [Модели аудио и речи](https://clipia.ai/ru/docs/models/audio): Какие модели Clipia озвучивают текст и пишут музыку — разработчики, языки, голоса, цены в кредитах и советы по выбору модели и голоса.

## Начало работы

- [Быстрый старт](https://clipia.ai/ru/docs/getting-started/quickstart): Первая генерация изображения через Clipia API за четыре шага — от создания ключа до готового результата, с примерами на cURL, TypeScript и Python.
- [Аутентификация](https://clipia.ai/ru/docs/getting-started/authentication): Как авторизовать запросы к Clipia API — API-ключ, три формы заголовка, боевые и тестовые ключи, права доступа и безопасное хранение ключа.
- [Тестовый режим](https://clipia.ai/ru/docs/getting-started/sandbox): Песочница Clipia API — ключ clipia_test_ проходит весь цикл submit, status, result и вебхук без списания кредитов и возвращает готовый образец.

## Справочник API

- [Обзор](https://clipia.ai/ru/docs/api-reference): Интерактивная справка Clipia REST API — параметры, схемы ответов, коды ошибок и отправка тестового запроса прямо со страницы документации.
- [Очередь генераций](https://clipia.ai/ru/docs/api-reference/overview): Как устроена асинхронная очередь Clipia REST API — отправка задачи, статус, результат и вебхуки для генерации изображений, видео и аудио.
- [Постановка генерации](https://clipia.ai/ru/docs/api-reference/submit): POST /v1/models/{model} — поставить генерацию изображения, видео или аудио в очередь, получить request_id и отправить запрос прямо со страницы.
- [Статус запроса](https://clipia.ai/ru/docs/api-reference/status): GET /v1/requests/{request_id}/status — лёгкий опрос статуса и прогресса генерации по request_id; отдельное право ключа для него не требуется.
- [Результат генерации](https://clipia.ai/ru/docs/api-reference/result): GET /v1/requests/{request_id} — забрать готовый результат со ссылками на изображение, видео или аудио; пока задача выполняется, API отвечает 202.
- [Каталог моделей](https://clipia.ai/ru/docs/api-reference/models): GET /v1/models — список моделей Clipia для изображений, видео и аудио с точными slug, схемой параметров и ценой, включая slug с косой чертой.
- [Seedance 2.5 API: параметры и цены](https://clipia.ai/ru/docs/api-reference/models/seedance-2-5): Seedance 2.5 в API Clipia — slug для T2V и I2V, ограничения параметров, проверка доступности в каталоге, оценка цены и отправка генерации через REST.
- [Оценка стоимости](https://clipia.ai/ru/docs/api-reference/estimate): POST /v1/models/{model}/estimate — узнать стоимость генерации в кредитах до запуска; задача не создаётся, кредиты не резервируются и не списываются.
- [Аккаунт и баланс](https://clipia.ai/ru/docs/api-reference/account): GET /v1/account — доступный баланс аккаунта в кредитах, число запросов и списанные кредиты этого ключа за последние 30 дней.
- [Идемпотентность](https://clipia.ai/ru/docs/api-reference/idempotency): Заголовок Idempotency-Key делает повтор отправки генерации безопасным — тот же запрос вернёт тот же request_id без второй задачи и второго списания.
- [Вебхуки](https://clipia.ai/ru/docs/api-reference/webhooks): POST-уведомление о завершении генерации на ваш сервер — формат тела, проверка подписи HMAC-SHA256, сроки ответа и расписание повторных доставок.
- [Лимиты](https://clipia.ai/ru/docs/api-reference/rate-limits): Лимиты Clipia API — 120 запросов в минуту на ключ и 600 на аккаунт, заголовки RateLimit-*, ответ 429, лимит параллельных генераций и LLM-лимиты.
- [Ошибки](https://clipia.ai/ru/docs/api-reference/errors): Единый формат ошибок Clipia API — поля type, code и message, таблица HTTP-статусов и кодов, какие ошибки повторять и как читать уточнение в message.
- [Управление ключами](https://clipia.ai/ru/docs/api-reference/keys): Как создать и отозвать API-ключ в консоли разработчика, что получает новый ключ, где взять секрет подписи вебхуков и сколько ключей можно держать.
- [Версии и совместимость](https://clipia.ai/ru/docs/api-reference/versioning): Clipia API развивается в одной версии /v1 — какие изменения считаются совместимыми, что попадает в changelog, устаревшие поля и версии SDK.

## AI Gateway

- [Clipia AI Gateway](https://clipia.ai/ru/docs/llm-gateway): Единый OpenAI-совместимый API к Claude, GPT, Gemini, DeepSeek и Grok с оплатой кредитами Clipia. Получите ключ и сделайте первый запрос за пару минут.
- [Chat Completions](https://clipia.ai/ru/docs/llm-gateway/chat-completions): POST /v1/chat/completions — OpenAI-совместимый чат Clipia AI Gateway. Обычный и потоковый ответ, параметры, роли, вызов инструментов и ошибки.
- [Модели и цены](https://clipia.ai/ru/docs/llm-gateway/models): Каталог LLM-моделей Clipia AI Gateway в GET /v1/models и цены в рублях за 1M токенов ввода и вывода — Claude, GPT, Gemini, DeepSeek и Grok.
- [LangChain](https://clipia.ai/ru/docs/llm-gateway/langchain): Подключите Clipia AI Gateway к LangChain через ChatOpenAI с base_url Clipia — чат, инструменты, агенты и структурированный вывод на Claude, GPT и Gemini.
- [Ключ и лимиты](https://clipia.ai/ru/docs/llm-gateway/account): GET /v1/key (ключ, расход за 30 дней, баланс и лимит), GET /v1/generation (стоимость запроса по id), заголовки лимитов и ответ 429 LLM-чата Clipia AI Gateway.

## MCP

- [Clipia для AI-агентов](https://clipia.ai/ru/docs/mcp): Подключите Clipia к Claude Code, claude.ai, ChatGPT, Cursor, VS Code, Codex и Gemini CLI — более 60 моделей фото и видео в чате агента по ключу или OAuth.
- [Инструменты MCP](https://clipia.ai/ru/docs/mcp/tools): Параметры 10 базовых и 5 дополнительных инструментов Clipia MCP, модели по умолчанию, slug с косой чертой и семь служебных инструментов карточек.

## SDK

- [TypeScript SDK](https://clipia.ai/ru/docs/sdk/typescript): Официальный TypeScript SDK Clipia (npm clipia-ai 1.5.0) — установка, очередь генераций, каталог и оценка цены, проверка вебхуков, ошибки и CLI clipia.
- [Python SDK](https://clipia.ai/ru/docs/sdk/python): Официальный Python SDK Clipia (PyPI clipia 1.5.0) — клиенты Clipia и AsyncClipia, очередь генераций, каталог и оценка цены, проверка вебхуков и ошибки.

## Руководства

- [Рекомендации](https://clipia.ai/ru/docs/guides/best-practices): Как надёжно интегрироваться с Clipia API — идемпотентные повторы, вебхуки вместо опроса, обработка ошибок и 429, оценка стоимости и хранение request_id.
- [Переход с другого API генерации](https://clipia.ai/ru/docs/guides/migration): Как перенести интеграцию с другого API генерации на Clipia — схема submit, status, result, ключи, вебхуки, кредиты и чек-лист перед запуском.

## Журнал изменений

- [Журнал изменений](https://clipia.ai/ru/docs/changelog): История изменений публичного API Clipia v1, MCP-сервера, LLM Gateway и SDK — запуск, новые инструменты и модели, обновления контракта и документации.