זיהוי ידוענים

שימו לב: התכונה הזו יצאה משימוש ולא תהיה זמינה יותר ב- Google Cloud 16 בספטמבר 2025.

בדף הזה מוסבר איך לזהות סלבריטאים בסרטון באמצעות Video Intelligence API.

‫Video Intelligence API יכול לבדוק את תוכן הווידאו כדי לזהות ולעקוב אחרי פנים של בני אדם שמופיעות בסרטון הקלט או בקטע הווידאו. כשמזהים פנים, Video Intelligence API יכול להשוות את הפנים לאוסף של סלבריטאים שאוסף Google.

אם נמצאה התאמה, Video Intelligence API מספק את מזהה המכונה (MID) של Knowledge Graph, את שם הסלבריטי ואת תיבת התוחמת שמציינת איפה הפנים מופיעות בסרטון.

בקשת גישה לתכונה

התכונה הזו מיועדת לשימוש של חברות מדיה ובידור או של שותפים מאושרים בתוכן מדיה שהופק באופן מקצועי. כדי לבקש גישה ל-API, צריך לשלוח את הטופס הזה עם מידע על החברה ועל תרחיש השימוש.

זיהוי של סלבריטי בסרטון

בדוגמאות הקוד הבאות אפשר לראות איך לזהות פנים של סלבריטי בסרטון. בדוגמה נעשה שימוש בשדה האופציונלי outputUri בבקשה כדי לציין מיקום לתוצאות ההערות.

הערה: השדה outputUri מציין קטגוריה של Cloud Storage לאחסון פלט האנוטציה. לפני ששולחים בקשה, צריך לוודא שלחשבון השירות יש הרשאת כתיבה לקטגוריית הפלט של Cloud Storage.

REST

שליחת הבקשה

בדוגמה הבאה אפשר לראות איך לשלוח בקשת POST ל-method‏ annotate. בדוגמה נעשה שימוש באסימון הגישה של חשבון שירות שהוגדר לפרויקט באמצעות Google Cloud CLI. הוראות להתקנת Google Cloud CLI, להגדרת פרויקט עם חשבון שירות ולקבלת אסימון גישה מופיעות במאמר מדריך למתחילים בנושא Video Intelligence.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫INPUT_URI: המיקום ב-Cloud Storage של קובץ הווידאו שרוצים להוסיף לו הערות.
• ‫OUTPUT_URI: המיקום ב-Cloud Storage שבו רוצים לשמור את התוצאות.
• ‫PROJECT_NUMBER: המזהה המספרי של Google Cloud הפרויקט

ה-method של ה-HTTP וכתובת ה-URL:

POST https://videointelligence.googleapis.com/v1p3beta1/videos:annotate

תוכן בקשת JSON:

{
  "inputUri": "gs://INPUT_URI",
  "outputUri": "gs://OUTPUT_URI",
  "features": ["CELEBRITY_RECOGNITION"]
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_NUMBER" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://videointelligence.googleapis.com/v1p3beta1/videos:annotate"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://videointelligence.googleapis.com/v1p3beta1/videos:annotate" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID"
}

אם הבקשה מצליחה, Video Intelligence מחזיר את השם של הפעולה.

קבלת התוצאות

כדי לקבל את תוצאות הבקשה, צריך לשלוח בקשת GET למשאב projects.operations. בדוגמה הבאה אפשר לראות איך לשלוח בקשה כזו.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫OPERATION_NAME: השדה name שמוחזר מהקריאה ל-Video Intelligence API. זהו ערך בפורמט:
  projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID,
  כאשר:
  • ‫PROJECT_NUMBER הוא המספר של הפרויקט שלך, Google Cloud
  • ‫LOCATION_ID הוא האזור ב-Cloud שבו בוצעו ההערות (לדוגמה: us-east1, ‏ us-west1, ‏ europe-west1,‏ asia-east1),
  • ‫OPERATION_ID הוא המזהה של הפעולה הממושכת.

ה-method של ה-HTTP וכתובת ה-URL:

GET https://videointelligence.googleapis.com/v1/OPERATION_NAME

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_NUMBER" \
     "https://videointelligence.googleapis.com/v1/OPERATION_NAME"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://videointelligence.googleapis.com/v1/OPERATION_NAME" | Select-Object -Expand Content

אתם אמורים לקבל תגובת JSON שדומה לזו:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.videointelligence.v1p3beta1.AnnotateVideoProgress",
    "annotationProgress": [
      {
        "inputUri": "INPUT_URI",
        "progressPercent": 100,
        "startTime": "2020-05-12T19:36:09.110351Z",
        "updateTime": "2020-05-12T19:36:17.519069Z"
      }
    ]
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.videointelligence.v1p3beta1.AnnotateVideoResponse",
    "annotationResults": [
      {
        ...
      }
    ]
  }
}

הפלט של הערות הסרטון אמור להיראות כמו בדוגמה הבאה.

{
  "annotationResults": [ {
    "inputUri": "INPUT_URI,
    "segment": {
      "startTimeOffset": {

      },
      "endTimeOffset": {
        "seconds": 19,
        "nanos": 519500000
      }
    },
    "celebrityRecognitionAnnotations": {
      "celebrityTracks": [ {
        "celebrities": [...],
        "faceTrack": {...}
      }, {
        "celebrities": [ {
          "celebrity": {
            "name": "video-intelligence/CELEBRITY_MID",
            "displayName": "CELEBRITY_NAME/var>"
          },
          "confidence": 0.81873637
        } ],
        "faceTrack": {
          "segment": {
            "startTimeOffset": {
              "seconds": 1,
              "nanos": 459791000
            },
            "endTimeOffset": {
              "seconds": 3,
              "nanos": 712041000
            }
          },
          "timestampedObjects": [ {
            "normalizedBoundingBox": {...},
            "timeOffset": {...}
          }, {
            "normalizedBoundingBox": {
              "left": 0.38046876,
              "top": 0.26249999,
              "right": 0.60312498,
              "bottom": 0.72361112
            },
            "timeOffset": {
              "seconds": 1,
              "nanos": 459791000
            }
          }, {
            "normalizedBoundingBox": {...},
            "timeOffset": {...}
          }]
        }
      }, {
        "celebrities": [...],
        "faceTrack": {...}
      } ]
    }
    ...
}

בקשה להסרת מפורסם

אם אתם סלבריטאים ולא רוצים להיכלל בתכונה הזו ב-Cloud Vision API או ב-Video Intelligence API, אתם יכולים לשלוח את הטופס הזה.

דיווח על שימוש לרעה

אם יש לך חשד לשימוש לרעה בתכונה לזיהוי אישים מפורסמים ב-Video Intelligence API, אפשר לעדכן אותנו באמצעות הטופס הזה.