La prova virtuale ti consente di generare immagini di persone che indossano prodotti di abbigliamento. Fornisci un'immagine di una persona e un prodotto di abbigliamento di esempio, quindi utilizza Prova virtuale per generare immagini della persona che indossa il prodotto.
Versioni del modello supportate
Prova virtuale supporta i seguenti modelli:
virtual-try-on-preview-08-04
Per saperne di più sulle funzionalità supportate dal modello, consulta Modelli Imagen.
Richiesta HTTP
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:predict \
-d '{
"instances": [
{
"personImage": {
"image": {
// Union field can be only one of the following:
"bytesBase64Encoded": string,
"gcsUri": string,
}
},
"productImages": [
{
"image": {
// Union field can be only one of the following:
"bytesBase64Encoded": string,
"gcsUri": string,
}
}
]
}
],
"parameters": {
"addWatermark": boolean,
"baseSteps": integer,
"personGeneration": string,
"safetySetting": string,
"sampleCount": integer,
"seed": integer,
"storageUri": string,
"outputOptions": {
"mimeType": string,
"compressionQuality": integer
}
}
}'
| Istanze | |
|---|---|
|
|
Obbligatorio. Un'immagine di una persona che prova il prodotto di abbigliamento, che può essere una delle seguenti:
|
|
|
Obbligatorio. Un'immagine di un prodotto da provare su una persona, che può essere una delle seguenti:
|
| Parametri | |
|---|---|
addWatermark |
Facoltativo. Aggiungi una filigrana invisibile alle immagini generate.
Il valore predefinito è |
|
|
Obbligatorio. Un numero intero che controlla la generazione di immagini, con un numero maggiore di passaggi che comporta una qualità superiore a scapito di una maggiore latenza. Valori interi maggiori di |
personGeneration |
Facoltativo. Consenti la generazione di persone da parte del modello. Sono supportati i seguenti valori:
Il valore predefinito è |
safetySetting |
Facoltativo. Aggiunge un livello di filtro al filtro di sicurezza. Sono supportati i seguenti valori:
Il valore predefinito è |
|
|
Obbligatorio. Il numero di immagini da generare.
Un valore intero compreso tra |
seed |
Facoltativo. Il seed casuale per la generazione di immagini. Questa opzione non è disponibile
quando |
storageUri |
Facoltativo. Un URI stringa di un percorso del bucket Cloud Storage per archiviare le immagini generate. |
outputOptions |
Facoltativo. Descrive il formato dell'immagine di output in un oggetto |
Oggetto delle opzioni di output
L'oggetto outputOptions descrive l'output dell'immagine.
| Parametri | |
|---|---|
outputOptions.mimeType |
(Facoltativo) Il formato di output dell'immagine. Sono supportati i seguenti valori:
Il valore predefinito è |
outputOptions.compressionQuality |
(Facoltativo)
Il livello di compressione se il tipo di output è
|
Richiesta di esempio
REST
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- REGION: la regione in cui si trova il progetto. Per ulteriori informazioni sulle regioni supportate, consulta Località dell'AI generativa su Vertex AI.
- PROJECT_ID: il tuo Google Cloud ID progetto.
- BASE64_PERSON_IMAGE: L'immagine codificata in Base64 della persona.
- BASE64_PRODUCT_IMAGE: L'immagine codificata in Base64 dell'immagine del prodotto.
-
IMAGE_COUNT: il numero di immagini da generare. L'intervallo accettato
di valori è compreso tra
1e4. - GCS_OUTPUT_PATH: il percorso Cloud Storage in cui archiviare l'output della prova virtuale.
Metodo HTTP e URL:
POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/publishers/google/models/virtual-try-on-preview-08-04:predict
Corpo JSON della richiesta:
{
"instances": [
{
"personImage": {
"image": {
"bytesBase64Encoded": "BASE64_PERSON_IMAGE"
}
},
"productImages": [
{
"image": {
"bytesBase64Encoded": "BASE64_PRODUCT_IMAGE"
}
}
]
}
],
"parameters": {
"sampleCount": IMAGE_COUNT,
"storageUri": "GCS_OUTPUT_PATH"
}
}
Per inviare la richiesta, scegli una di queste opzioni:
curl
Salva il corpo della richiesta in un file denominato request.json,
ed esegui questo comando:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/publishers/google/models/virtual-try-on-preview-08-04:predict"
PowerShell
Salva il corpo della richiesta in un file denominato request.json,
ed esegui questo comando:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/publishers/google/models/virtual-try-on-preview-08-04:predict" | Select-Object -Expand Content
{
"predictions": [
{
"mimeType": "image/png",
"bytesBase64Encoded": "BASE64_IMG_BYTES"
},
{
"bytesBase64Encoded": "BASE64_IMG_BYTES",
"mimeType": "image/png"
}
]
}