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

> Produci video da un frame iniziale, da testo, o da testo con lo stile dei tuoi modelli addestrati.

`POST /videos/generations` produce un video in una di tre modalità, selezionata
dal campo `mode`:

* **`image_to_video`** — anima un frame iniziale, con un frame finale facoltativo
  sugli engine che supportano il frame finale.
* **`text_to_video`** — genera una clip da un prompt soltanto.
* **`text_to_video_styled`** — un prompt più i modelli addestrati della tua
  organizzazione.

Le capacità dell'engine (modalità supportate, durate, risoluzioni, aspect ratio,
supporto per frame finale e audio, e prezzi) provengono da
[`GET /videos/models`](/it/api-reference/videos/list-engines) — leggilo prima per
scegliere una combinazione valida di `engine` + `duration`.

## Pattern asincrono

`POST /videos/generations` restituisce **`202 Accepted`** con un `id` del job;
interroga
[`GET /videos/generations/{id}`](/it/api-reference/videos/get-generation) finché
non è `completed`, poi leggi il video prodotto (presigned URL valido per **24
ore**). Un `webhook_url` ti dà una callback push — vedi
[Webhook](/it/guides/webhooks).

## Credits

I credits dei video scalano con la tariffa al secondo dell'engine, la durata, il
moltiplicatore di risoluzione e il moltiplicatore audio — vedi
`credits_per_second` e i moltiplicatori in
[`GET /videos/models`](/it/api-reference/videos/list-engines). I costi attingono
dal pool della tua organizzazione; un pool esaurito restituisce `402`. Vedi
[Prezzi](/it/guides/pricing).