---
title: "Génération d'images"
method: POST
path: "/v1/images/generations"
---

# Génération d'images

`POST /v1/images/generations`

## Request

- Base URL: `https://api.kooma.ai`
- URL: `https://api.kooma.ai/v1/images/generations`
- Auth: none declared

Produit une ou plusieurs images a partir d'une description.

`quality` choisit la gamme : `standard` (19 F l'image) ou `premium` (36 F, definition superieure).
Le format se donne par `size` (1024x1024, 1792x1024, 1024x1792, 1024x768, 768x1024) ou par
`aspect_ratio` (1:1, 16:9, 9:16, 4:3, 3:4). Reponse : `{"created": ..., "data": [{"url", "image_id"}]}`,
ou `b64_json` a la place de `url` si `response_format` vaut `b64_json`.

L'`image_id` renvoye est directement utilisable par le module video : on peut generer une image
puis l'animer sans la re-televerser.

## Request body

- ImageRequest
  - `prompt` string, required: Description de l'image a produire.
  - `quality` string: Gamme : 'standard' (19 F) ou 'premium' (36 F, definition superieure).
  - `size` string, nullable: Taille : 1024x1024, 1792x1024, 1024x1792, 1024x768, 768x1024 ou 'auto'.
  - `aspect_ratio` string, nullable: Format, au choix de `size` : 1:1, 16:9, 9:16, 4:3 ou 3:4.
  - `n` integer: Nombre d'images (1 a 4).
  - `response_format` string: 'url' (defaut) ou 'b64_json'.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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