# API Z Image Riferimento API completo per la generazione da testo a immagine Z Image. ## Varianti del modello Questa API supporta una variante del modello: | Modello | ID | Descrizione | |-------|-----|-------------| | **Z Image** | `z-image` | Generazione rapida da testo a immagine | ## Confronto rapido | Funzionalità | Z Image | |---------|---------| | Input | Prompt testuale | | Output | Singola immagine generata | | Rapporti d'aspetto | Più rapporti supportati | | Risoluzione | Derivata dai valori del rapporto width/height | | `seed` | Facoltativo | ### Rapporti d'aspetto supportati La coppia `width:height` deve essere una delle seguenti: `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `9:16`, `16:9`, `9:21` ## Z Image (testo a immagine) ### Punto di accesso ``` POST /api/v1/image/task ``` ### Parametri della richiesta #### Obbligatori | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `model_name` | string | Deve essere `"z-image"` | | `prompt` | string | Prompt di generazione immagine | | `width` | number | Valore del rapporto di larghezza (ad es. `16` per `16:9`) | | `height` | number | Valore del rapporto di altezza (ad es. `9` per `16:9`) | #### Facoltativi | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `seed` | number | Seed casuale nell'intervallo `[0, 2147483647]`. Usa `null` o `0` per la generazione casuale. | ### Richiesta di esempio ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'z-image', prompt: 'A cinematic portrait of a traveler standing on a cliff at golden hour', width: 16, height: 9, seed: 0 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Formato della risposta Risposta di invio: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}", "task_status": "submitted" } } ``` Esegui il polling con `GET /api/v1/image/{task_id}`. Stati del task: `submitted`, `processing`, `succeed`, `failed`. Le risposte di polling riuscite espongono gli URL delle immagini generate in `data.task_result.images[].url`. ## Best practice - Usa valori di rapporto, non dimensioni in pixel, per `width` e `height`. - Mantieni i prompt descrittivi ma focalizzati su soggetto, illuminazione e composizione. - Usa un `seed` fisso quando vuoi generazioni riproducibili durante i test.