---
title: "Запрос на генерацию изображения"
method: POST
path: "/v1/images/generations"
tags: ["Creation"]
---

# Запрос на генерацию изображения

`POST /v1/images/generations`

Эта конечная точка служит для генерации изображений с помощью нейросетей. **Для доступа требуется авторизация.**

*Обратите внимание, что сгенерированные изображения передаваемые в формате `url` доступны только 24 часа по ссылке, далее они удаляются с сервера.*

## Request body

- ImageGenerationForm
  - `model` string, required — Модель к которой вы хотите отправть запрос
  - `prompt` string, required — Описание что вы хотите сгенерировать
  - `negative_prompt` string, nullable — Описание что вы хотите сгенерировать
  - `n` integer — Сколько изображений генерировать
  - `response_format` 'url' | 'b64_json'
  - `size` string — Размер генерируемого изображения
  - `quality` string, nullable — Качество генерируемого изображения
  - `style` string, nullable — Стиль генерируемого изображения
  - `image_url` union — URL-адрес или base64 входного/эталонного изображения для редактирования.
    - string
    - string[]

## Response `200`

Successful Response

- ImageGenerationResponse
  - `id` string, required
  - `created` integer, required
  - `data` Datum[], required
    - `revised_prompt` string, nullable
    - `b64_json` string, nullable
    - `url` string, nullable
  - `usage` CoreSchemasImageGenerationUsage, required
    - `total_time` number, required
    - `cost_request` number, required
    - `free_request` boolean, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/hydraai/apis/hydraai-api.md) · [All operations](https://skmtc.dev/hydraai/apis/hydraai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hydraai/hydraai-api/revisions/e628fe769ab4/schema)