Начало работы с API KIE
Добро пожаловать в KIE. Это руководство поможет вам ознакомиться с основной информацией для интеграции KIE API в ваш продукт: модели, тарифы, аутентификация, порядок запросов, лимиты и поддержка. Мы стремимся быть прозрачными, практичными и удобными для разработчиков. Пожалуйста, внимательно ознакомьтесь с этим перед запуском в продакшене.
1. Доступные модели и плейграунд (Playground)
Последние поддерживаемые модели вы найдете на странице Маркета:
👉 https://kie.ai/marketМы постоянно обновляем и добавляем новые модели по мере их стабилизации.
На каждой странице модели есть ссылка на Playground, где вы можете протестировать и поэкспериментировать прямо в интерфейсе перед вызовом API.
Playground — лучшее место для понимания поведения модели, её параметров и форматов вывода.
2. Цены и тарифы
Полный и актуальный список цен доступен здесь:
👉 https://kie.ai/pricingНаши цены обычно на 30–50% ниже, чем у официальных API.
Для некоторых моделей скидки могут достигать 80%.
Цены могут меняться в зависимости от изменений у поставщиков, поэтому всегда обращайтесь к странице с актуальными тарифами.
3. Создание и защита API-ключа
Создавайте и управляйте своими API-ключами здесь:
👉 https://kie.ai/api-keyВажные замечания по безопасности:
Никогда не размещайте свой API-ключ в клиентском коде (в браузере, мобильных приложениях или публичных репозиториях).
Считайте ваш API-ключ конфиденциальной информацией.Чтобы защитить вашу активность, мы предоставляем:
Ограничения по частоте запросов на ключ (часовые, суточные и общие лимиты использования)
Поддержка белого списка IP-адресов, позволяющая использовать API только с одобренных серверов
Эти функции помогают избежать случайного превышения лимитов и несанкционированных запросов.
4. Необходимые заголовки запроса
Каждый запрос к API должен содержать корректные заголовки:Authorization: Bearer <ВАШ_API_КЛЮЧ>
Content-Type: application/jsonЕсли заголовки отсутствуют или указаны неверно, вы можете получить следующую ошибку:
{"code":401,"msg":"Недостаточно прав для выполнения запроса"}Всегда проверяйте заголовки при отладке проблем с авторизацией.
5. Логи и детали задач
Здесь вы можете просмотреть все свои предыдущие задачи:
👉 https://kie.ai/logsДля каждой задачи можно увидеть:
Время создания
Использованная модель
Входные параметры
Статус задачи
Расход кредитов
Финальные результаты или информацию об ошибкахЕсли вы подозреваете ошибку в списании кредитов, эта страница — точка истины для проверки расхода кредитов.
6. Политика хранения данных
Обратите внимание на наши правила хранения:
Сгенерированные медиа-файлы: хранятся 14 дней, затем автоматически удаляются
Записи логов (текст / метаданные): хранятся 2 месяца, затем автоматически удаляютсяЕсли вам нужен долгосрочный доступ, обязательно скачайте и сохраните результаты на своём сервере заранее.
7. Асинхронная модель обработки задач
Все задачи генерации в KIE выполняются асинхронно.Успешный запрос возвращает:
HTTP 200
task_idОтвет 200 означает только, что задача была создана, но еще не завершена.Чтобы получить финальный результат, необходимо:
Указать URL обратного вызова (webhook) в запросе, или
Активно опрашивать API «query record info» с использованием task_id
8. Ограничения по частоте и одновременным запросам
По умолчанию применяются следующие ограничения:
Максимум 20 запросов на создание контента за 10 секунд
Это обычно позволяет одновременно выполнять более 100 задач
Ограничения действуют на каждый аккаунт отдельноЕсли вы превысите лимит:
Запросы будут отклонены с кодом HTTP 429
Отклонённые запросы не попадают в очередьДля большинства пользователей это более чем достаточно. Если вы часто получаете ошибку 429, вы можете связаться с поддержкой для увеличения лимита — решения принимаются осторожно.
9. Поддержка для разработчиков
Рекомендуемые каналы поддержки доступны прямо из панели управления (нижнее левое меню):
Получить помощь в Discord
Получить помощь в TelegramЧто вы получаете:
Приватные каналы связи
Ваши данные и переписка остаются конфиденциальными
Быстрые и точные технические ответыВремя работы поддержки: с 21:00 до 17:00 UTC следующего дня
Вы также можете написать нам на [email protected], но это не самый быстрый способ получения помощи.
10. Стабильность работы
Мы предлагаем доступ к передовым API по очень привлекательным тарифам.Однако:
Мы не идеальны
Наша стабильность может быть немного ниже, чем у официальных провайдеров
Это сознательный выбор, который мы сделалиНа практике KIE достаточно стабилен для поддержки рабочих нагрузок в продакшене и долгосрочного роста бизнеса, но мы хотим быть честными с вами с самого начала.
11. О команде
KIE создан небольшой командой стартапа.
Мы быстро развиваемся
Мы уделяем большое внимание опыту разработчиков
Постоянно улучшаем наш продуктОднако мы признаём:
Не всё идеально
Не всегда можно удовлетворить все запросы сразуВаш отзыв помогает нам становиться лучше — и мы искренне ценим каждую обратную связь.