> ## 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.

# Génération d'images

> Génère des images à partir d'un prompt, en composant éventuellement les modèles entraînés de ton organisation.

Transforme un prompt texte en images avec `POST /images/generations`, en composant
éventuellement les modèles **style**, **object**, **person** et **setting**
entraînés de ton organisation, plus une **palette de couleurs**. Le engine par
défaut est `nano_banana_pro` (passe `engine` pour sélectionner `nano_banana_2`).

## Modèle asynchrone

La génération est asynchrone. `POST /images/generations` renvoie immédiatement
**`202 Accepted`** avec un `id` de job, un `status` et une valeur
`estimated_credits`. Interroge
[`GET /images/generations/{id}`](/fr/api-reference/images/get-generation) jusqu'à ce
que `status` soit `completed` (ou `failed`/`cancelled`), puis lis les images
produites — chacune porte une presigned URL valable **24 heures**. Passe un
`webhook_url` pour être notifié au lieu d'interroger (voir
[Webhooks](/fr/guides/webhooks)).

## Credits

Chaque sortie (output) coûte `5` credits en `1K`, en fonction de la résolution
(`1K` ×1, `2K` ×2, `4K` ×4) et multiplié par `num_outputs`. Les coûts puisent dans
le pool de ton organisation ; un pool épuisé renvoie `402`. Voir
[Tarifs](/fr/guides/pricing).

<Card title="Quickstart" icon="rocket" href="/fr/quickstart">
  Un parcours complet de zéro jusqu'à l'image avec curl, Python et TypeScript.
</Card>
