Создание API-ключей
Существует два вида API-токенов:- Личные API-токены действуют от вашего имени: запросы выполняются под вашей собственной учётной записью Krea, с вашей ролью в рабочем пространстве и доступом к вашим стилям. Создать такой токен может любой участник рабочего пространства; личный токен перестаёт работать, если вы покидаете рабочее пространство.
- Сервисные API-токены действуют от имени отдельного сервисного пользователя в вашем рабочем пространстве, а не от имени создавшего их человека. Создавать их могут только владельцы и администраторы рабочего пространства. Сервисные токены продолжают работать, даже если их создатель покидает рабочее пространство. Владельцы и администраторы рабочего пространства видят все токены в рабочем пространстве, а для каждого сервисного токена отслеживаются расходы за последние 30 дней.
- Перейдите на krea.ai/app/api/tokens
- Нажмите Create Personal Token или Create Service Token
- Дайте ключу понятное название
- Сохраните токен в надёжном месте — он показывается только один раз!
Личные API-токены работают от имени вашей собственной учётной записи Krea, поэтому стили, обученные вами в приложении, доступны им напрямую. Сервисные API-токены работают как отдельная пользовательская идентичность внутри вашего рабочего пространства: стили, обученные в приложении, недоступны через сервисный токен, а стили, обученные через сервисный токен, не появляются в приложении, если только они не предоставлены рабочему пространству. Подробности см. в разделе Обучение собственного стиля.
Использование API-ключей
Включайте свой токен в заголовокAuthorization всех запросов:
Цены
Цены по каждой модели смотрите на странице krea.ai/app/api/pricing ↗. У каждой модели фиксированная стоимость одной генерации, определяемая параметрами вашего запроса (разрешение, качество, аудио, длительность, референсы стиля и т. д.).Как работает биллинг API
Прямые вызовы API и MCP-подключения, использующие API-токен, списываются с отдельного USD-баланса вашего рабочего пространства — независимо от compute-юнитов, используемых веб-приложением Krea. MCP-подключения через OAuth списываются с учётной записи Krea, в которую выполнен вход, и оплачиваются compute-юнитами. Перед использованием API-ключей в вашем рабочем пространстве должен быть включён доступ к API; если он не включён, обратитесь в support@krea.ai ↗.Agent API и инструменты агента — исключение: ходы агента расходуют баланс compute-юнитов рабочего пространства, в том числе при аутентификации с помощью API-ключа. API-баланс они не используют.
Неудачные и отменённые задачи не тарифицируются. Вы платите только за успешно завершённые задачи.
Когда баланс заканчивается
Уже запущенные задачи завершаются как обычно. Новые API-запросы отклоняются с ошибкой HTTP 402 Payment Required:402 из-за API-баланса. Ответ 402 для Zero Data Retention и другие ответы 402 перечислены в разделе Ошибки и отладка.
Пополнение API-баланса
Добавляйте средства на krea.ai/app/api/. Пополнять API-баланс могут только владельцы рабочего пространства.- Предустановленные суммы: $10, $25, $50, $100
- Произвольная сумма: минимум $5, максимум $10,000
- Оплата через Stripe Checkout; баланс пополняется сразу после успешной оплаты
Отслеживание расходов
Завершённые API-задачи и их ориентировочная стоимость за выбранный период отображаются на странице API Usage по адресу krea.ai/app/api/usage. Менеджеры рабочего пространства видят использование по всему рабочему пространству; остальные участники видят использование только своих токенов. Карточка API-баланса на странице krea.ai/app/api/ также показывает ориентировочную стоимость API за последние 7 дней.Корпоративным клиентам
Клиентам с большими объёмами доступна ежемесячная оплата по счетам с условиями Net 30 вместо предоплаты. Обсудить корпоративный биллинг можно по адресу sales@krea.ai ↗.
Дальнейшие шаги
Интерактивная песочница
Сделайте свой первый API-запрос
API моделей
Изучите все доступные эндпоинты
Жизненный цикл задачи
Разберитесь в состояниях задач и опросе их статуса
Ограничения по частоте
Узнайте об API-лимитах в зависимости от тарифа