Skip to main content

​
Обзор

Все запросы на генерацию проходят через один и тот же базовый жизненный цикл: Job lifecycle diagram

​
Состояния задания

queued Задание ожидает обработки в очереди backlogged Задание ожидает освобождения слота в вашем текущем лимите параллелизма scheduled Задание принято и запланировано к обработке processing Задание активно обрабатывается воркером sampling Задание генерирует выходные сэмплы intermediate-complete У задания есть промежуточный результат, обработка может продолжаться completed Задание успешно завершено, результат доступен в result.urls failed Задание завершилось ошибкой, подробности в result.error cancelled Задание отменено пользователем или системой

​
Ошибки и отмена

Задание может завершиться неудачно по нескольким причинам:
  • Ошибки API сервиса генерации
  • Некорректные параметры или неподдерживаемые конфигурации
  • Модерация контента (NSFW-фильтрация)
  • Автоматическое обнаружение таймаута (3 минуты для наших инструментов, 2 часа для внешних провайдеров)
Как отменить задание: отправьте DELETE-запрос на /jobs/{id}. Обратите внимание: задание можно отменить только когда его статус — queued или processing.
Важно: неудачные и отменённые задания не тарифицируются. Вы платите только за завершённые задания.

​
Проверка статуса задания

Опрашивайте статус задания GET-запросом на /jobs/{id}. Рекомендуемые практики:
  • Опрашивайте каждые 2–5 секунд, пока задание в ожидании (backlogged, queued, scheduled, processing, sampling или intermediate-complete)
  • Используйте экспоненциальный backoff для более длительных заданий
  • Прекращайте опрос, когда статус — completed, failed или cancelled
  • Некоторые задания могут включать превью-изображения в ответах на стадии processing
Пример реализации опроса: 
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

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

async function waitForJob(jobId) {
  const job = await krea.jobs.wait(jobId, { intervalMs: 2000 });
  return job.result;
}

​
Следующие шаги

Webhooks

Получайте уведомления о завершении заданий

Лимиты запросов

Разберитесь с лимитами API по тарифам

Model APIs

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

API-ключи и биллинг

Создавайте и управляйте API-ключами