Начало работы с 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 создан небольшой командой стартапа. Мы быстро развиваемся Мы уделяем большое внимание опыту разработчиков Постоянно улучшаем наш продукт Однако мы признаём: Не всё идеально Не всегда можно удовлетворить все запросы сразу Ваш отзыв помогает нам становиться лучше — и мы искренне ценим каждую обратную связь.