視覚的類似性

メモ

Content and Commerce AI はベータ版です。 このドキュメントは変更される場合があります。

視覚類似性サービスは、画像を指定すると、カタログから視覚的に類似した画像を自動的に見つけます。

このドキュメントの例では、次の画像が使用されています。

テスト画像

API 形式

POST /services/v1/predict

リクエスト

次のリクエストは、ペイロードで指定された入力パラメーターに基づいて、カタログから視覚的に類似した画像を取得します。 表示される入力パラメーターの詳細については、サンプルのペイロードの下の表を参照してください。

注意

analyzer_id どれを決定するか Sensei Content Framework が使用されます。 適切な analyzer_id リクエストを送信する前に Content and Commerce AI ベータチームに連絡し、 analyzer_id を設定します。

curl -i -X POST https://sensei.adobe.io/services/v1/predict \
  -H 'Authorization: Bearer $API_TOKEN' \
  -H 'Content-Type: multipart/form-data' \
  -H 'cache-control: no-cache,no-cache' \
  -H 'x-api-key: $API_KEY' \
  -F file=@test_image.jpg \
  -F 'contentAnalyzerRequests={
   "enable_diagnostics":"true",
   "requests":[
     {
         "analyzer_id": "Feature:cintel-deep-product-search:Service-316a8cf750c6440396061c8f73a7a585",
         "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": {}
            }]
          }
      }
    ]
}'
プロパティ 説明 必須
analyzer_id この Sensei リクエストがデプロイされるサービス ID。 この ID によって Sensei Content Frameworks が使用されます。 カスタムサービスの場合は、Content and Commerce AI チームに連絡して、カスタム ID を設定してください。
application-id 作成したアプリケーションの ID。
data 配列内の各オブジェクトが画像を表す JSON オブジェクトを含む配列。 この配列の一部として渡されたパラメータは、 data 配列。 この表で説明する残りのプロパティは、内から上書きできます。 data.
content-id 応答で返されるデータ要素の一意の ID。 この値が渡されない場合は、自動生成された ID が割り当てられます。 ×
content 視覚類似性サービスによって分析されるコンテンツ。 画像がリクエスト本文に含まれる場合、 -F file=@<filename> curl コマンドで画像を渡し、このパラメーターは空の文字列のままにします。
画像が S3 上のファイルの場合、署名済み URL を渡します。 コンテンツがリクエスト本文に含まれている場合、データ要素のリストには 1 つのオブジェクトのみを含める必要があります。 複数のオブジェクトが渡された場合は、最初のオブジェクトのみが処理されます。
content-type 入力がリクエスト本文に含まれているか、S3 バケットの署名済み URL に含まれているかを示すために使用されます。 このプロパティのデフォルトはです。 inline. ×
encoding 入力画像のファイル形式。 現在、JPEGと PNG 画像のみを処理できます。 このプロパティのデフォルトはです。 jpeg. ×
threshold 結果を返す必要があるスコアのしきい値 (0 ~ 1)。 値を使用 0 すべての結果を返します。 このプロパティのデフォルトはです。 0. ×
top-N 返される結果の数(負の整数は指定できません)。 値を使用 0 すべての結果を返します。 を threshold返される結果の数は、どちらの制限セットの小さい方です。 このプロパティのデフォルトはです。 0. ×
custom 渡すカスタムパラメーター。 ×
historic-metadata メタデータを渡すことができる配列。 ×

応答

成功すると、 response 配列に含まれる feature_value および feature_name カタログ内の視覚的に類似した画像ごとに

次の例の応答では、視覚的に類似した画像が返されています。

類似画像

{
  "status": 200,
  "content_id": "test_image.jpg",
  "cas_responses": [
    {
      "status": 200,
      "analyzer_id": "Feature:cintel-deep-product-search:Service-316a8cf750c6440396061c8f73a7a585",
      "content_id": "test_image.jpg",
      "result": {
        "response_type": "feature",
        "response": [
          {
            "feature_value": [
              {
                "feature_value": "678",
                "feature_name": "G34WS945.F1"
              },
              {
                "feature_value": "678",
                "feature_name": "1431RDM JANELLE RAW JACKE"
              },
              {
                "feature_value": "657",
                "feature_name": "GF4045877841 CARLA FLR"
              },
              {
                "feature_name": "1707-686-SGU PATCH XYZ",
                "feature_value": "657"
              },
              {
                "feature_name": "5495MJT AJA BLK",
                "feature_value": "646"
              },
              {
                "feature_name": "IDEAL",
                "feature_value": "645"
              },
              {
                "feature_value": "644",
                "feature_name": "HCAJRA439 CALI JEAN"
              },
              {
                "feature_name": "KT279RK-ONL",
                "feature_value": "644"
              },
              {
                "feature_name": "SP190404-ELLIS",
                "feature_value": "642"
              },
              {
                "feature_name": "GF4174848718 KENDALL DIS",
                "feature_value": "640"
              }
            ],
            "feature_name": "visual_similarity"
          }
        ]
      }
    }
  ],
  "error": []
}

このページ