1. Search

サポートされているビジュアル検索パラメーター

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

このSearch APIを使用して、ビジュアル検索呼び出しを行い、既に使用可能なアセットに基づいて、関連または類似の画像、アーカイブ、ベクターを見つけることができます。

パラメーター

パラメーター

形容

例

defaults 

使用するデフォルト設定を指定します。

RelationEditorSearchConfiguration 

filters 

  • name - フィルタリングするプロパティ。

  • operator - フィルター操作。

  • values - フィルター値。

  • type - フィルターのタイプ。

  • definitionName 

  • 5平等のために

  • "M.Asset" 

  • 1プロパティフィルター用

fields 

検索結果で取得するフィールドを指定します。

Title, Filename

visualSearch 

  • type - ビジュアル検索方法。

  • text - 視覚的な類似性のためのテキストベースの入力。

  • color - 類似性マッチングの色。

  • image - 視覚的な比較のためのbase64エンコードされた画像。

  • imageEntityId: 比較する既存のアセットのID。

  • vector 

  • "cocktails on the beach" 

  • "yellow" 

  • "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/..." 

  • 12345 

メモ

各リクエストには、"type": "vector" と、text、color、image、またはimageEntityIdのいずれか1つのパラメーターのみを含める必要があります。

例

テキストのSearch:

{
   "defaults":"RelationEditorSearchConfiguration",
   "filters":[
      {
         "name":"definitionName",
         "operator":15,
         "values":[
            "M.Asset"
         ],
         "type":1
      }
   ],

   "fields":[
      "Title",
      "Filename"
   ],
   "visualSearch":{
        "type":"vector",
        "text":"cocktails on the beach"
    }
}
{
  "query": "",
  "skip": 0,
  "take": 10,
  "totalItemCount": 50,
  "returnedItemCount": 10,
  "sorting": {},
  "sortingOptions": [],
  "filters": [],
  "fulltext": [],
  "facets": [],
  "items": [
    {
      "id": 32769,
      "identifier": "asset.bundo-kim-558517",
      "cultures": [],
      "properties": {
        "FileName": "bundo-kim-558517.jpg",
        "Title": "Lemonade with pink straw"
      },
      ...
    },
    ...
  ],
  "aggregations": null,
  "grouped_view": null,
  "visualSearch": {
    "imageLink": null,
    "color": null,
    "text": "cocktails on the beach",
    "type": "vector",
    "imageEntityId": null,
    "removeQuery": ""
  }
}

色でSearch:

{
   "defaults":"RelationEditorSearchConfiguration",
   "filters":[
      {
         "name":"definitionName",
         "operator":15,
         "values":[
            "M.Asset"
         ],
         "type":1
      }
   ],
   "fields":[
      "Title",
      "Filename"
   ],

   "visualSearch":{
        "type":"vector",
        "color":"yellow"
    }
}
{
    "query": "",
    "skip": 0,
    "take": 10,
    "totalItemCount": 50,
    "returnedItemCount": 10,
    "sorting": {},
    "sortingOptions": [],
    "filters": [],
    "fulltext": [],
    "facets": [],
    "items": [
        {
            "id": 32772,
            "identifier": "asset.charity-beth-long-629533",
            "cultures": [],
            "properties": {
                "FileName": "charity-beth-long-629533.jpg",
                "Title": "Rehydrating Lemon Spritz"
            },
            ...
        },
        ...
    ],
    "aggregations": null,
    "grouped_view": null,
    "visualSearch": {
        "imageLink": null,
        "color": "yellow",
        "text": null,
        "type": "vector",
        "imageEntityId": null,
        "removeQuery": ""
    }
}

画像によるSearch:

{

   "defaults":"RelationEditorSearchConfiguration",

   "filters":[

      {

         "name":"definitionName",

         "operator":15,

         "values":[

            "M.Asset"

         ],
         "type":1
      }
   ],

   "fields":[
      "Title",
      "Filename"
   ],

   "visualSearch":{
        "type":"vector",
        "image":"data:image/jpeg;base64,<YOUR_BASE64_IMAGE>"
    }

}
{
    "query": "",
    "skip": 0,
    "take": 10,
    "totalItemCount": 50,
    "returnedItemCount": 10,
    "sorting": {},
    "sortingOptions": [],
    "filters": [],
    "fulltext": [],
    "facets": [],
    "items": [
        {
            "id": 32859,
            "identifier": "asset.logo-flavorful-white.ai",
            "cultures": [],
            "properties": {
                "FileName": "logo-flavorful-white.ai",
                "Title": "Flavorful logo (white)"
            },
            ...
        },
        ...
    ],
    "aggregations": null,
    "grouped_view": null,
    "visualSearch": {
        "imageLink": null,
        "color": null,
        "text": null,
        "type": "vector",
        "imageEntityId": null,
        "removeQuery": ""
    }
}

類似のアセットのSearch

{
   "defaults":"RelationEditorSearchConfiguration",
   "filters":[
      {
         "name":"definitionName",
         "operator":15,
         "values":[
            "M.Asset"
         ],
         "type":1
      }
   ],

   "fields":[
      "Title",
      "Filename"
   ],
    "visualSearch":{
        "type":"vector",
        "imageEntityId":<ID_OF_ASSET_TO_COMPARE_WITH>
    }
}
{
    "query": "",
    "skip": 0,
    "take": 10,
    "totalItemCount": 50,
    "returnedItemCount": 10,
    "sorting": {},
    "sortingOptions": [],
    "filters": [],
    "fulltext": [],
    "facets": [],
    "items": [
        {
            "id": 33276,
            "identifier": "asset.filter-2.png",
            "cultures": [],
            "properties": {
                "FileName": "filter-2.png",
                "Title": "Filter layer 2"
            },
            ...
        },
        ...
    ],
    "aggregations": null,
    "grouped_view": null,
    "visualSearch": {
        "imageLink": "https://<YOUR_INSTANCE>/api/delivery/local-358b1d15db434a4cb60b9c6a7e40b7d9?expires=2025-01-10T11%3A50%3A07.7802694%2B00%3A00&entityid=32859&rendition=thumbnail&signature=qQ9yUY6ra6s",
        "color": null,
        "text": null,
        "type": "vector",
        "imageEntityId": 32859,
        "removeQuery": ""
    }
}
この記事を改善するための提案がある場合は、 お知らせください!