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

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

Создавать API-токены могут только владельцы и администраторы рабочего пространства. Если вы не видите кнопки создания токена, обратитесь к владельцу рабочего пространства, чтобы запросить доступ или повышенную роль. Чтобы создать API-ключ:
  1. Перейдите на krea.ai/settings/api-tokens
  2. Убедитесь, что вы находитесь в нужном рабочем пространстве (с помощью переключателя рабочих пространств в левом верхнем углу)
  3. Нажмите «New Token»
  4. Дайте токену понятное название
  5. Сохраните токен в надёжном месте — он показывается только один раз!
API работает как отдельная пользовательская идентичность внутри вашего рабочего пространства. Стили, обученные в приложении, недоступны через API, а стили, обученные через API, не появляются в приложении, если только они не предоставлены рабочему пространству. Подробности см. в разделе Обучение собственного стиля.
Рекомендации по безопасности
  • Храните токены в переменных окружения, а не в коде
  • Используйте разные токены для разработки и продакшена
  • Немедленно отзывайте токены при их компрометации
  • Никогда не отправляйте токены в систему контроля версий
  • Никогда не публикуйте токены в открытом доступе

​
Использование API-ключей

Включайте свой токен в заголовок Authorization всех запросов: 
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const job = await krea.image("bfl/flux-1-dev", {
  prompt: "a serene mountain landscape at sunset",
  width: 1024,
  height: 576
});

console.log(`Job ID: ${job.job_id}`);

​
Цены

Цены по каждой модели смотрите на странице krea.ai/features/api ↗. У каждой модели фиксированная стоимость одной генерации, определяемая параметрами вашего запроса (разрешение, качество, аудио, длительность, референсы стиля и т. д.).

​
Как работает биллинг API

Прямые вызовы API и MCP-подключения, использующие API-токен, списываются с отдельного USD-баланса вашего рабочего пространства — независимо от compute-юнитов, используемых веб-приложением Krea. MCP-подключения через OAuth списываются с учётной записи Krea, в которую выполнен вход, и оплачиваются compute-юнитами. Перед использованием API-ключей в вашем рабочем пространстве должен быть включён доступ к API; если он не включён, обратитесь в support@krea.ai ↗.
Неудачные и отменённые задачи не тарифицируются. Вы платите только за успешно завершённые задачи.

​
Когда баланс заканчивается

Уже запущенные задачи завершаются как обычно. Новые API-запросы отклоняются с ошибкой HTTP 402 Payment Required: 
{
  "message": "Your API balance is separate from your workspace compute balance. Please top up your API balance to continue using the API."
}
Чтобы продолжить работу, пополните баланс на krea.ai/app/api/. Публичного эндпоинта для программной проверки баланса нет — отслеживайте его в приложении.

​
Пополнение API-баланса

Добавляйте средства на krea.ai/app/api/. Пополнять API-баланс могут только владельцы рабочего пространства.
  • Предустановленные суммы: $10, $25, $50, $100
  • Произвольная сумма: минимум $5, максимум $10,000
  • Оплата через Stripe Checkout; баланс пополняется сразу после успешной оплаты

​
Отслеживание расходов

Недавние траты отображаются в карточке API-баланса на странице krea.ai/app/api/ в разделе «API cost in the last 7 days».

​
Корпоративным клиентам

Клиентам с большими объёмами доступна ежемесячная оплата по счетам с условиями Net 30 вместо предоплаты. Обсудить корпоративный биллинг можно по адресу sales@krea.ai ↗.

​
Дальнейшие шаги

Интерактивная песочница

Сделайте свой первый API-запрос

API моделей

Изучите все доступные эндпоинты

Жизненный цикл задачи

Разберитесь в состояниях задач и опросе их статуса

Ограничения по частоте

Узнайте об API-лимитах в зависимости от тарифа