

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Richiesta e risposta Stable Image Ultra
<a name="model-parameters-diffusion-stable-ultra-text-image-request-response"></a>

Il corpo della richiesta viene passato nel `body` campo di una richiesta all'[InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html)operazione. 

**Campo del corpo della richiesta per l’invocazione del modello**

Quando effettui una InvokeModel chiamata utilizzando un modello Stable Image Ultra, riempi il campo body con un oggetto JSON simile al seguente. 
+ **prompt**: (stringa) cosa desideri vedere nell’immagine di output. Un prompt forte e descrittivo che definisca chiaramente elementi, colori e soggetti porterà a risultati migliori.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/bedrock/latest/userguide/model-parameters-diffusion-stable-ultra-text-image-request-response.html)

**Campo del corpo delle risposte per l’invocazione del modello**

Quando effettui una chiamata `InvokeModel` utilizzando un modello Stable Image Ultra, la risposta è simile alla seguente. 

```
{
         'seeds': [2130420379], 
         "finish_reasons":[null], 
         "images":["..."]
     }
```

Una risposta con una “finish reason” diversa da `null` avrà il seguente aspetto:

```
{
         "finish_reasons":["Filter reason: prompt"]
     }
```
+ **seeds**: (stringa) elenco dei seed utilizzati per generare immagini per il modello.
+ **finish\$1reasons**: enum che indica se la richiesta è stata filtrata o meno. `null` indica che la richiesta è andata a buon fine. Valori correnti possibili: `"Filter reason: prompt", "Filter reason: output image", "Filter reason: input image", "Inference error", null`.
+ **images**: un elenco di immagini generate in formato stringa base64.

Per ulteriori informazioni, consultate [https://platform.us.stability. ai/docs/api-reference\$1tag/v1 generazione](https://platform.us.stability.ai/docs/api-reference#tag/v1generation).

------
#### [ Text to image ]

Il modello Stability.ai Stable Image Ultra ha i seguenti parametri di inferenza per una chiamata di text-to-image inferenza. 
+ **prompt**: (stringa) cosa desideri vedere nell’immagine di output. Un prompt forte e descrittivo che definisca chiaramente elementi, colori e soggetti porterà a risultati migliori.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/bedrock/latest/userguide/model-parameters-diffusion-stable-ultra-text-image-request-response.html)

**Campi opzionali**
+ **aspect\$1ratio**: (stringa) controlla le proporzioni dell’immagine generata. Questo parametro è valido solo per text-to-image le richieste. Impostazione predefinita: 1:1. Enum: 16:9, 1:1, 21:9, 2:3, 3:2, 4:5, 5:4, 9:16, 9:21.
+ **modalità**: imposta su text-to-image. Predefinito: text-to-image. Enum: `text-to-image`.
+ **output\$1format**: specifica il formato dell’immagine di output. Formati supportati: JPEG, PNG. Dimensioni supportate: altezza da 640 a 1.536 px, larghezza da 640 a 1.536 px.
+ **seed**: (numero) un valore specifico utilizzato per determinare la “casualità” della generazione. Ometti questo parametro o passa 0 per utilizzare un seed casuale. Intervallo: da 0 a 4294967295.
+ **negative\$1prompt**: parole chiave che indicano ciò che non desideri vedere nell’immagine di output. Massimo: 10.000 caratteri.

```
import boto3
       import json
       import base64
       import io
       from PIL import Image
       
       bedrock = boto3.client('bedrock-runtime', region_name='us-west-2')
       response = bedrock.invoke_model(
           modelId='stability.sd3-ultra-v1:1',
           body=json.dumps({
               'prompt': 'A car made out of vegetables.'
           })
       )
       output_body = json.loads(response["body"].read().decode("utf-8"))
       base64_output_image = output_body["images"][0]
       image_data = base64.b64decode(base64_output_image)
       image = Image.open(io.BytesIO(image_data))
       image.save("image.png")
```

------
#### [ Image to image ]

Il modello Stability.ai Stable Image Ultra ha i seguenti parametri di inferenza per una chiamata di image-to-image inferenza.
+ **prompt**: (stringa) cosa desideri vedere nell’immagine di output. Un prompt forte e descrittivo che definisca chiaramente elementi, colori e soggetti porterà a risultati migliori.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/bedrock/latest/userguide/model-parameters-diffusion-stable-ultra-text-image-request-response.html)

**Campi opzionali**
+ **image**: (stringa) immagine Base64 da utilizzare come punto di partenza per la generazione. Formati supportati: JPEG, PNG, WebP.
+ **strength**: (numero) quanto influisce il parametro image sull’immagine generata. Le immagini con valori di strength inferiori avranno un aspetto più simile all’immagine originale. Intervallo: da 0,0 a 1,0. Impostazione predefinita: 0,35.
+ **aspect\$1ratio**: (stringa) controlla le proporzioni dell’immagine generata. Questo parametro è valido solo per text-to-image le richieste. Impostazione predefinita: 1:1. Enum: 16:9, 1:1, 21:9, 2:3, 3:2, 4:5, 5:4, 9:16, 9:21.
+ **output\$1format**: specifica il formato dell’immagine di output. Formati supportati: JPEG, PNG. Dimensioni supportate: altezza da 640 a 1.536 px, larghezza da 640 a 1.536 px.
+ **seed**: (numero) un valore specifico utilizzato per determinare la “casualità” della generazione. Ometti questo parametro o passa 0 per utilizzare un seed casuale. Intervallo: da 0 a 4294967295.
+ **negative\$1prompt**: parole chiave che indicano ciò che non desideri vedere nell’immagine di output. Massimo: 10.000 caratteri.

```
import boto3
       import json
       import base64
       import io
       from PIL import Image
       
       bedrock = boto3.client('bedrock-runtime', region_name='us-west-2')
       response = bedrock.invoke_model(
           modelId='stability.sd3-ultra-v1:1',
           body=json.dumps({
               'prompt': 'A car made out of vegetables.'
           })
       )
       output_body = json.loads(response["body"].read().decode("utf-8"))
       base64_output_image = output_body["images"][0]
       image_data = base64.b64decode(base64_output_image)
       image = Image.open(io.BytesIO(image_data))
       image.save("image.png")
```

------