> ## Documentation Index
> Fetch the complete documentation index at: https://docs.samsa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Generazione di immagini

> Genera immagini da un prompt, componendo facoltativamente i modelli addestrati della tua organizzazione.

Trasforma un prompt testuale in immagini con `POST /images/generations`,
componendo facoltativamente i modelli **style**, **object**, **person** e
**setting** addestrati della tua organizzazione, più una **color palette**.
L'engine predefinito è `nano_banana_pro` (passa `engine` per selezionare
`nano_banana_2`).

## Pattern asincrono

La generazione è asincrona. `POST /images/generations` restituisce
immediatamente **`202 Accepted`** con un `id` del job, uno `status` e un valore
`estimated_credits`. Interroga
[`GET /images/generations/{id}`](/it/api-reference/images/get-generation) finché
`status` non è `completed` (oppure `failed`/`cancelled`), poi leggi le immagini
prodotte — ognuna include un presigned URL valido per **24 ore**. Passa un
`webhook_url` per essere notificato invece di interrogare (vedi
[Webhook](/it/guides/webhooks)).

## Credits

Ogni output costa `5` credits a `1K`, con scalatura in base alla risoluzione
(`1K` ×1, `2K` ×2, `4K` ×4) e moltiplicato per `num_outputs`. I costi attingono
dal pool della tua organizzazione; un pool esaurito restituisce `402`. Vedi
[Prezzi](/it/guides/pricing).

<Card title="Quickstart" icon="rocket" href="/it/quickstart">
  Una guida completa dallo zero all'immagine con curl, Python e TypeScript.
</Card>
