Разделы документации

Генерация изображений

Метод генерации изображений: POST https://api.apikley.ru/v1/images/generations. Передайте API-ключ и JSON с непустым model. Остальные обязательные поля определяет выбранная модель.

Выберите модель и параметры

В каталоге есть Black Forest Labs flux1-kontext (Pro) и Black Forest Labs flux-2 pro (1.0s, 1k, Pro). Используйте внешний ID со страницы модели. Проверяйте её входные данные, параметры и цену перед отправкой.

Универсальной схемы медиа-запроса нет. Нельзя переносить параметры одной модели на другую без проверки. Публичные параметры маршрутизации могут содержать callStyle, fixedParams и defaultParams. Конфликт с фиксированным значением даёт 400 kie_param_fixed.

На маршруте со схемой генерации параметры могут фильтроваться. Пути отброшенных параметров передаются в x-apikley-dropped-params.

Ответ может быть задачей

Не рассчитывайте на универсальный массив data[] с готовыми изображениями. Метод может вернуть объект принятой задачи. HTTP 200 с taskId означает принятие, а не готовый результат.

Форма принятой задачи; taskId условный

{"code":200,"msg":"success","data":{"taskId":"TASK_ID_FROM_RESPONSE"}}
  1. Сохраните data.taskId из ответа.
  2. Проверяйте состояние через GET-маршрут семейства выбранной модели с параметром taskId и тем же заголовком API-ключа. Пути /api/v1/... ниже отсчитываются от https://api.apikley.ru, а не от базового URL /v1.
  3. Проверяйте HTTP-статус, поле code и результат по контракту семейства. Для успешного изображения нужна ссылка на результат; одного значения состояния недостаточно.
СемействоМаршрут проверкиРезультат
JobsGET /api/v1/jobs/recordInfo?taskId=...data.state; строку data.resultJson нужно разобрать как JSON и прочитать resultUrls.
Flux KontextGET /api/v1/flux/kontext/record-info?taskId=...Ссылка в data.response.resultImageUrl.
GPT-4o ImageGET /api/v1/gpt4o-image/record-info?taskId=...Ссылки в data.response.resultUrls.

Для Jobs состояния waiting, queuing, generating означают ожидание или выполнение; success обозначает успешное состояние у провайдера, fail обозначает ошибку. Готовность изображения проверяйте по ссылкам в resultUrls. У других семейств поля и значения состояния отличаются.

Другие медиа

Для видеозадач, например Veo и Runway, предусмотрены отдельные контракты. У Veo результат находится в data.response.resultUrls или data.response.fullResultUrls, у Runway: в data.videoInfo.videoUrl. Не применяйте к ним автоматически схему изображений.

Частые вопросы

Можно ли включить stream для изображения?

Генерация изображений отклоняет streaming с 400 provider_streaming_not_supported. Для задачи используйте проверку статуса.

Почему в ответе нет URL изображения?

Возможно, вернулся только taskId принятой задачи. Проверьте её состояние по соответствующему маршруту.

Где узнать цену и правила обработки данных?

Цена и параметры находятся на странице модели. Правила обработки данных: политика конфиденциальности. См. также оплату.

Обновлено