Il rilevamento di contenuti espliciti rileva contenuti per adulti nei video. I contenuti per adulti sono generalmente inappropriati per i minori di 18 anni e includono, a titolo esemplificativo, nudità, atti sessuali e pornografia. Vengono identificati anche i contenuti presenti nei cartoni animati o negli anime.
La risposta include un valore di probabilità suddiviso in bucket, compreso tra VERY_UNLIKELY
e VERY_LIKELY
.
Quando il rilevamento di contenuti espliciti valuta un video, lo fa in base al frame e prende in considerazione solo i contenuti visivi. Il componente audio del video non viene utilizzato per valutare il livello dei contenuti espliciti.
Ecco un esempio di esecuzione di un'analisi video per le funzionalità di rilevamento di contenuti espliciti su un file che si trova in Cloud Storage.
REST
Invia una richiesta di annotazione video
Di seguito viene mostrato come inviare una richiesta POST al metodo videos:annotate
. L'esempio utilizza Google Cloud CLI per creare un token di accesso. Per istruzioni sull'installazione di gcloud CLI, consulta la guida rapida dell'API Video Intelligence.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- INPUT_URI: un bucket Cloud Storage che contiene il file da annotare, incluso il nome del file. Deve
iniziare con
gs://
.
Ad esempio:"inputUri": "gs://cloud-videointelligence-demo/assistant.mp4",
- PROJECT_NUMBER: l'identificatore numerico del tuo progetto Google Cloud
Metodo HTTP e URL:
POST https://videointelligence.googleapis.com/v1/videos:annotate
Corpo JSON della richiesta:
{ "inputUri": "INPUT_URI", "features": ["EXPLICIT_CONTENT_DETECTION"] }
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID" }
Se la risposta ha esito positivo, l'API Video Intelligence restituisce name
per l'operazione. Quanto sopra mostra un esempio di risposta di questo tipo, in cui:
- PROJECT_NUMBER: il numero del tuo progetto.
- LOCATION_ID: la regione Cloud in cui deve essere eseguita l'annotazione. Le regioni cloud supportate sono:
us-east1
,us-west1
,europe-west1
easia-east1
. Se non viene specificata alcuna regione, ne verrà determinata una in base alla posizione del file video. - OPERATION_ID: l'ID dell'operazione a lunga esecuzione creata
per la richiesta e fornito nella risposta quando hai avviato
l'operazione, ad esempio
12345...
Ottieni i risultati delle annotazioni
Per recuperare il risultato dell'operazione, effettua una richiesta GET utilizzando il
nome dell'operazione restituito dalla chiamata a videos:annotate
, come mostrato
nell'esempio seguente.
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- OPERATION_NAME: il nome dell'operazione
restituita dall'API Video Intelligence. Il nome dell'operazione ha il formato
projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID
- PROJECT_NUMBER: l'identificatore numerico del tuo progetto Google Cloud
Metodo HTTP e URL:
GET https://videointelligence.googleapis.com/v1/OPERATION_NAME
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID", "metadata": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1.AnnotateVideoProgress", "annotationProgress": [ { "inputUri": "/demomaker/gbikes_dinosaur.mp4", "progressPercent": 100, "startTime": "2020-03-26T00:16:35.112404Z", "updateTime": "2020-03-26T00:16:55.937889Z" } ] }, "done": true, "response": { "@type": "type.googleapis.com/google.cloud.videointelligence.v1.AnnotateVideoResponse", "annotationResults": [ { "inputUri": "/demomaker/gbikes_dinosaur.mp4", "explicitAnnotation": { "frames": [ { "timeOffset": "0.056149s", "pornographyLikelihood": "VERY_UNLIKELY" }, { "timeOffset": "1.166841s", "pornographyLikelihood": "VERY_UNLIKELY" }, ... { "timeOffset": "41.678209s", "pornographyLikelihood": "VERY_UNLIKELY" }, { "timeOffset": "42.596413s", "pornographyLikelihood": "VERY_UNLIKELY" } ] } } ] } }
shotAnnotations
.
Nota: il campo done viene restituito solo quando il valore è True.
Non è incluso nelle risposte per cui l'operazione non è stata completata.
Scarica i risultati delle annotazioni
Copia l'annotazione dall'origine al bucket di destinazione: (vedi Copiare file e oggetti)
gsutil cp gcs_uri gs://my-bucket
Nota: se l'URI GCS di output è fornito dall'utente, l'annotazione viene archiviata nell'URI GCS.
Go
Java
Per autenticarti a Video Intelligence, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per autenticarti a Video Intelligence, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per ulteriori informazioni sull'installazione e sull'utilizzo della libreria client dell'API Cloud Video Intelligence per Python, consulta Librerie client dell'API Cloud Video Intelligence.Linguaggi aggiuntivi
C#: segui le istruzioni per la configurazione di C# nella pagina delle librerie client e poi consulta la documentazione di riferimento di Video Intelligence per .NET.
PHP: segui le istruzioni per la configurazione di PHP nella pagina delle librerie client e poi consulta la documentazione di riferimento di Video Intelligence per PHP.
Ruby: segui le istruzioni per la configurazione di Ruby nella pagina delle librerie client e poi visita la documentazione di riferimento di Video Intelligence per Ruby.