A experiência virtual permite-lhe gerar imagens de pessoas a usar produtos de vestuário. Fornece uma imagem de uma pessoa e um produto de vestuário de amostra e, em seguida, usa a experiência de prova virtual para gerar imagens da pessoa a usar o produto.
Versões de modelos suportadas
A experiência de teste virtual suporta os seguintes modelos:
virtual-try-on-preview-08-04
Para mais informações sobre as funcionalidades suportadas pelo modelo, consulte os modelos Imagen.
Pedido 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
}
}
}'
Instâncias | |
---|---|
|
Obrigatório. Uma imagem de uma pessoa para experimentar o produto de vestuário, que pode ser uma das seguintes opções:
|
|
Obrigatório. Uma imagem de um produto para experimentar numa pessoa, que pode ser qualquer uma das seguintes opções:
|
Parâmetros | |
---|---|
addWatermark |
Opcional. Adicionar uma marca de água invisível às imagens geradas.
O valor predefinido é |
|
Obrigatório. Um número inteiro que controla a geração de imagens, com passos mais elevados, que trocam uma qualidade mais elevada por uma latência aumentada. Valores inteiros superiores a |
personGeneration |
Opcional. Permitir a geração de pessoas pelo modelo. Os seguintes valores são suportados:
O valor predefinido é |
safetySetting |
Opcional. Adiciona um nível de filtro à filtragem de segurança. Os seguintes valores são suportados:
O valor predefinido é |
|
Obrigatório. O número de imagens a gerar.
Um valor inteiro entre |
seed |
Opcional. A semente aleatória para a geração de imagens. Esta opção não está disponível quando |
storageUri |
Opcional. Um URI de string para uma localização do contentor do Cloud Storage para armazenar as imagens geradas. |
outputOptions |
Opcional. Descreve o formato da imagem de saída num |
Objeto de opções de saída
O objeto outputOptions
descreve a saída da imagem.
Parâmetros | |
---|---|
outputOptions.mimeType |
Opcional: O formato de saída da imagem. Os seguintes valores são suportados:
O valor predefinido é |
outputOptions.compressionQuality |
Opcional:
O nível de compressão se o tipo de saída for
|
Exemplo de pedido
REST
Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:
- REGION: a região onde o seu projeto está localizado. Para mais informações sobre as regiões suportadas, consulte as localizações da IA generativa no Vertex AI.
- PROJECT_ID: o seu Google Cloud ID do projeto.
- BASE64_PERSON_IMAGE: a imagem codificada em Base64 da imagem da pessoa.
- BASE64_PRODUCT_IMAGE: a imagem codificada em Base64 da imagem do produto.
-
IMAGE_COUNT: o número de imagens a gerar. O intervalo de valores
aceite é de
1
a4
. - GCS_OUTPUT_PATH: O caminho do Cloud Storage para armazenar o resultado da experiência virtual.
Método 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 do pedido:
{ "instances": [ { "personImage": { "image": { "bytesBase64Encoded": "BASE64_PERSON_IMAGE" } }, "productImages": [ { "image": { "bytesBase64Encoded": "BASE64_PRODUCT_IMAGE" } } ] } ], "parameters": { "sampleCount": IMAGE_COUNT, "storageUri": "GCS_OUTPUT_PATH" } }
Para enviar o seu pedido, escolha uma destas opções:
curl
Guarde o corpo do pedido num ficheiro com o nome request.json
,
e execute o seguinte 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
Guarde o corpo do pedido num ficheiro com o nome request.json
,
e execute o seguinte 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" } ] }