Extraktion

HINWEIS

Content and Commerce AI in der Betaphase enthalten. Die Dokumentation kann geändert werden.

Der Dienst für Extraktion von Farben kann ein Histogramm von Pixelfarben berechnen und durch vorherrschende Farben in Behältern sortieren. Die Farben in den Bildpixeln werden zu 40 vorherrschenden Farben zusammengefasst, die für das Farbspektrum repräsentativ sind. Ein Histogramm mit Farbwerten wird dann unter diesen 40 Farben berechnet. Der Dienst hat zwei Varianten:

Extraktion (Vollbild)

Diese Methode extrahiert ein Farbhistogramm über das gesamte Bild.

Extraktion (mit Maske)

Diese Methode verwendet einen tief lernenden Vordergrundextraktor, um Objekte im Vordergrund zu identifizieren. Das Modell wird auf einem Katalog von E-Commerce-Bildern trainiert. Sobald das Vordergrundobjekt extrahiert wurde, wird ein Histogramm über die dominanten Farben berechnet, wie zuvor beschrieben.

In dem in diesem Dokument gezeigten Beispiel wurde folgende Abbildung verwendet:

Testbild

API-Format

POST /services/v1/predict

Anfrage

Die folgende Beispielanforderung verwendet die Vollbildmethode für die Extraktion von Farben.

Die folgende Anforderung extrahiert Farben aus einem Bild basierend auf den in der Payload bereitgestellten Eingabeparametern. Weitere Informationen zu den angezeigten Eingabeparametern finden Sie in der Tabelle unter der Beispielpayload.

VORSICHT

analyzer_id bestimmt, welche verwendet Sensei Content Framework wird. Bitte überprüfen Sie, ob Sie die richtige analyzer_id haben, bevor Sie Ihre Anfrage machen. Für den Extraktion-Dienst lautet die analyzer_id-ID:
Feature:image-color-histogram:Service-6fe52999293e483b8e4ae9a95f1b81a7

curl -i -X POST https://sensei.adobe.io/services/v1/predict \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: multipart/form-data' \
  -H 'x-api-key: {API_KEY}' \
  -H 'cache-control: no-cache,no-cache' \
  -F file=@test_image.jpg \
  -F 'contentAnalyzerRequests={
   "enable_diagnostics":"true",
   "requests":[
     {
         "analyzer_id": "Feature:image-color-histogram:Service-6fe52999293e483b8e4ae9a95f1b81a7",
         "parameters": {
          "application-id": "1234", 
          "content-type": "inline", 
          "encoding": "jpeg", 
          "threshold": "0", 
          "top-N": "0", 
          "custom": {}, 
          "data": [{
            "content-id": "0987", 
            "content": "inline-image", 
            "content-type": "inline", 
            "encoding": "jpeg", 
            "threshold": "0", 
            "top-N": "0", 
            "historic-metadata": [], 
            "custom": {"exclude_mask": 1}
            }]
          }
      }
    ]
}'
Eigenschaft Beschreibung Obligatorisch
analyzer_id Die Sensei-Dienst-ID, unter der Ihre Anforderung bereitgestellt wird. Diese ID bestimmt, welche der Sensei Content Frameworks verwendet werden. Wenden Sie sich bei benutzerdefinierten Diensten an das Content and Commerce AI-Team, um eine benutzerdefinierte ID einzurichten. Ja
application-id Die ID der erstellten Anwendung. Ja
data Ein Array, das JSON-Objekte enthält. Jedes Objekt im Array stellt ein Bild dar. Alle Parameter, die als Teil dieses Arrays übergeben werden, setzen die globalen Parameter außer dem Array data außer Kraft. Die übrigen Eigenschaften, die unten in dieser Tabelle aufgeführt sind, können innerhalb von data überschrieben werden. Ja
content-id Die eindeutige ID für das Datenelement, das in der Antwort zurückgegeben wird. Wenn dies nicht weitergegeben wird, wird eine automatisch generierte ID zugewiesen. Nein
content Der vom Extraktion-Dienst zu analysierende Inhalt. Verwenden Sie im Ereignis, dass das Image zum Anforderungstext gehört, -F file=@<filename> im curl-Befehl, um das Image zu übergeben, wobei dieser Parameter eine leere Zeichenfolge bleibt.
Wenn das Bild eine Datei auf S3 ist, übergeben Sie die signierte URL. Wenn der Inhalt zum Anforderungstext gehört, sollte die Liste der Datenelemente nur ein Objekt enthalten. Wenn mehr als ein Objekt übergeben wird, wird nur das erste Objekt verarbeitet.
Ja
content-type Wird verwendet, um anzugeben, ob die Eingabe Teil des Anforderungstextes oder einer signierten URL für einen S3-Behälter ist. Die Standardeinstellung für diese Eigenschaft ist inline. Nein
encoding Das Dateiformat des Eingabebilds. Derzeit können nur JPEG- und PNG-Bilder verarbeitet werden. Die Standardeinstellung für diese Eigenschaft ist jpeg. Nein
threshold Der Schwellenwert des Ergebnisses (0 bis 1), ab dem die Ergebnisse zurückgegeben werden müssen. Verwenden Sie den Wert 0, um alle Ergebnisse zurückzugeben. Die Standardeinstellung für diese Eigenschaft ist 0. Nein
top-N Die Anzahl der zurückzugebenden Ergebnisse (darf keine negative Ganzzahl sein). Verwenden Sie den Wert 0, um alle Ergebnisse zurückzugeben. Bei Verwendung in Verbindung mit threshold ist die Anzahl der zurückgegebenen Ergebnisse die niedrigere der beiden angegebenen Grenzwerte. Die Standardeinstellung für diese Eigenschaft ist 0. Nein
custom Alle benutzerdefinierten Parameter, die übergeben werden sollen. Nein
historic-metadata Ein Array, an das Metadaten übergeben werden können. Nein

Antwort

Eine erfolgreiche Antwort gibt die Details der extrahierten Farben zurück. Jede Farbe wird durch einen feature_value-Schlüssel dargestellt, der die folgenden Informationen enthält:

  • Ein Farbname
  • Der Prozentsatz, in dem diese Farbe im Verhältnis zum Bild angezeigt wird
  • Der RGB-Wert der Farbe

Im ersten Beispielobjekt unten bedeutet das feature_value von White,0.59,251,251,243, dass die gefundenen Farben weiß und Weiß in 59 % des Bildes vorkommen und den RGB-Wert 251.251.243 haben.

{
  "status": 200,
  "content_id": "test_image.jpg",
  "cas_responses": [
    {
      "status": 200,
      "analyzer_id": "Feature:image-color-histogram:Service-e952f4acd7c2425199b476a2eb459635",
      "content_id": "test_image.jpg",
      "result": {
        "response_type": "feature",
        "response": [
          {
            "feature_value": [
              {
                "feature_name": "color_name_and_rgb",
                "feature_value": "White,0.59,251,251,243"
              },
              {
                "feature_value": "Orange,0.30,248,169,48",
                "feature_name": "color_name_and_rgb"
              },
              {
                "feature_name": "color_name_and_rgb",
                "feature_value": "Mustard,0.08,251,199,77"
              },
              {
                "feature_name": "color_name_and_rgb",
                "feature_value": "Gold,0.02,250,191,55"
              }
            ],
            "feature_name": "color"
          }
        ]
      }
    }
  ],
  "error": []
}
Eigenschaft Beschreibung
content_id Der Name des Bilds, das in Ihrer POST hochgeladen wurde.
feature_value Ein Array, dessen Objekte Schlüssel mit demselben Eigenschaftennamen enthalten. Diese Schlüssel enthalten eine Zeichenfolge, die den Farbnamen darstellt, einen Prozentwert, den diese Farbe im Verhältnis zum Bild, das in content_id gesendet wird, und den RGB-Wert der Farbe angibt.

Auf dieser Seite

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free