Перейти к основному содержанию

Создание API-ключей

Существует два вида API-токенов:
  • Личные API-токены действуют от вашего имени: запросы выполняются под вашей собственной учётной записью Krea, с вашей ролью в рабочем пространстве и доступом к вашим стилям. Создать такой токен может любой участник рабочего пространства; личный токен перестаёт работать, если вы покидаете рабочее пространство.
  • Сервисные API-токены действуют от имени отдельного сервисного пользователя в вашем рабочем пространстве, а не от имени создавшего их человека. Создавать их могут только владельцы и администраторы рабочего пространства. Сервисные токены продолжают работать, даже если их создатель покидает рабочее пространство. Владельцы и администраторы рабочего пространства видят все токены в рабочем пространстве, а для каждого сервисного токена отслеживаются расходы за последние 30 дней.
Чтобы создать API-ключ:
  1. Перейдите на krea.ai/app/api/tokens
  2. Нажмите Create Personal Token или Create Service Token
  3. Дайте ключу понятное название
  4. Сохраните токен в надёжном месте — он показывается только один раз!
Личные 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:
Чтобы продолжить работу, пополните баланс на krea.ai/app/api/. Публичного эндпоинта для программной проверки баланса нет — отслеживайте его в приложении. Это тело ответа соответствует ошибке 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-лимитах в зависимости от тарифа