---
title: "Сгенерировать изображение"
method: POST
path: "/v1/images/generations"
tags: ["Images"]
---

# Сгенерировать изображение

`POST /v1/images/generations`

## Request

- Base URL: `https://api.hubris.pw`
- URL: `https://api.hubris.pw/v1/images/generations`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.hubris.pw/oauth/authorize`, token URL `https://api.hubris.pw/oauth/token`, scopes: `chat:write`)

OpenAI Images API-совместимая генерация картинок по текстовому описанию. Картинки приходят в base64 (`b64_json`).

Модели с генерацией изображений: `GET /v1/models?output_modalities=image`. Провайдер-специфичные поля (`aspect_ratio`, `resolution`, `seed`, `input_references`) передаются как есть. Списание — по итоговой стоимости картинок.

## Request body

- ImageGenerationRequest
  - `model` string, required
  - `prompt` string, required
  - `n` integer: Сколько изображений (клиппится по лимиту модели).
  - `size` string: Размер, напр. "1024x1024" или тир "2K".
  - `response_format` 'b64_json' | 'url': MVP всегда отдаёт b64_json.

## Response `200`

Сгенерированные изображения: `{ created, data: [{ b64_json }] }`

## Other responses

- `400`: Невалидный запрос
- `402`: Недостаточно средств
- `404`: Модель не найдена
- `502`: Ошибка апстрима / не удалось определить стоимость
- `503`: Курс валют недоступен

---

[API](https://skmtc.dev/hubris/apis/hubris-api.md) · [All operations](https://skmtc.dev/hubris/apis/hubris-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hubris/apis/hubris-api/revisions/79ea91ed8f10?raw)