Публичный API и SDK для Python и JavaScript

Публичный API Clipia — это REST-интерфейс на api.clipia.ai/v1 с официальными SDK для JavaScript/TypeScript и Python, который позволяет запускать генерацию изображений и видео прямо из вашего кода. Один HTTP-запрос с Bearer-ключом возвращает готовый файл, статус задачи и точную стоимость в кредитах — без браузера, копирования ссылок и ручных действий.

Что даёт

• Запуск генерации из кода: отправляйте промпт и параметры в любую из 50+ моделей и получайте изображения или видео программно — для ботов, сервисов, плагинов и автоматизации контента.
• Статус и оценка стоимости: опрашивайте состояние задачи в реальном времени и заранее узнавайте, сколько кредитов спишется, ещё до запуска генерации, чтобы планировать расходы.
• Баланс и каталог моделей: проверяйте остаток кредитов и получайте актуальный список доступных моделей вместе с их параметрами и ценами одним вызовом API.
• Официальные SDK: npm-пакет clipia-ai для JavaScript/TypeScript и PyPI-пакет clipia для Python — с типами, автодополнением и готовыми примерами запросов.

Как начать

Создайте API-ключ в Консоли разработчика, установите SDK командой npm i clipia-ai или pip install clipia и отправьте первый запрос с Bearer-аутентификацией. Полное описание эндпоинтов, параметров моделей, форматов ответа и кодов ошибок собрано в документации с примерами на нескольких языках. Для безопасных повторов передавайте заголовок Idempotency-Key — он гарантирует, что одна и та же задача не запустится и не оплатится дважды.

Для кого

API подойдёт разработчикам, которые встраивают генерацию в свои продукты: Telegram-боты, SaaS-сервисы, плагины, конвейеры автоматизации контента и пакетную обработку. Идемпотентность запросов защищает от двойных списаний при повторах, а единый формат ответов и предсказуемые коды ошибок делают интеграцию надёжной и устойчивой к сбоям сети.

Частые вопросы

Как проходит аутентификация? По Bearer API-ключу: ключ создаётся в Консоли разработчика и передаётся в заголовке каждого запроса. У одного аккаунта может быть несколько ключей с раздельной статистикой использования.

Сколько моделей доступно через API? Более 50 моделей генерации изображений и видео — тот же каталог, что и на сайте, от фото до видео разной длительности и соотношения сторон, доступный одним запросом к эндпоинту моделей.

Что вернётся при нехватке кредитов? Понятный код ошибки с указанием причины — недостаточно кредитов или требуется активная подписка, — чтобы приложение могло корректно обработать ситуацию и подсказать пользователю следующий шаг.