--- title: "アセット検索のリクエスト" slug: "maiu-search-asset" updated: 2026-09-17T09:58:08Z published: 2026-09-17T09:58:08Z canonical: "api.ncloud-docs.com/maiu-search-asset" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # アセット検索のリクエスト VPC環境で利用できます。 テキスト、画像、人物、セリフの条件を利用してアセットを検索します。 参考 - アセット検索リクエストは非同期で処理し、[アセット検索結果の照会](/docs/ja/maiu-get-asset-search-result)にて結果を確認できます。 - クエリは1つだけ入力可能で、`textQuery`または`imageQuery`のうち、いずれか一方だけ使用できます。 - フィルタは、人物(persons)とセリフ(dialogues)に基づいて must、any、not条件を設定できます。 - 1分当たり1,000回まで呼び出すことができます。呼び出し数の調整が必要な場合、[サポート](https://www.ncloud.com/support/question/service?parentCode=O2O_MEDIA&code=O2O_MEDIA_012)までお問い合わせください。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | POST | /api/v1/workspaces/{workspace_name}/assets/search | ### リクエストヘッダ Media Intelligence APIで共通して使用されるヘッダの詳細は、[Media Intelligenceのリクエストヘッダ](/docs/ja/maiu-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 ### リクエストボディ リクエストボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `query` | Object | Required | メディアアセット検索条件(テキスト、画像、人物、セリフ) | | `queryOption` | Object | Optional | 類似度信頼レベルの設定 | | `filter` | Object | Optional | 検索対象プロジェクト、ビデオ、インデックスの更新日フィルタ | #### `query` `query`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `textQuery` | String | Conditional | メディアアセットのテキストクエリ - `textQuery`または`imageQuery`は必ず入力 - セミコロン(`;`)、バーティカルバー(`\\|`)、バッククォート(```)は使用できない | | `imageQuery` | String | Conditional | アップロード完了した画像ファイルのキー値 - `textQuery`または`imageQuery`は必ず入力 | | `personQuery` | Object | Optional | メディアアセット内に含めるか、除外する人物の条件 | | `personQuery.must` | Array | Optional | 必ず含めるべき人物 IDリスト | | `personQuery.any` | Array | Optional | 1つ以上含まれるべき人物 IDリスト | | `personQuery.not` | Array | Optional | 含めてはいけない人物 IDリスト | | `dialogQuery` | Object | Optional | ビデオのメディアアセット内に含めるか、除外するセリフの条件 - セミコロン(`;`)、バーティカルバー(`\\|`)、バッククォート(```)は使用できない - 画像アセットは0と表示 | | `dialogQuery.must` | Array | Optional | ビデオ内で必ず含めるべきセリフリスト - 画像アセットは0と表示 | | `dialogQuery.any` | Array | Optional | ビデオ内で1つ以上含まれるべきセリフリスト - 画像アセットは0と表示 | | `dialogQuery.not` | Array | Optional | ビデオ内で含めてはいけないセリフリスト - 画像アセットは0と表示 | #### `queryOption` `queryOption`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `confidenceLevel` | String | Optional | 類似度信頼レベル - `LOW` \| `MEDIUM`(デフォルト) \| `HIGH` | #### `filter` `filter`の説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `projectIds` | Array | Conditional | 検索するプロジェクト IDリスト - `projectIds`または`assetIds`は必ず入力 | | `assetIds` | Array | Conditional | 検索するメディアアセット IDリスト - `projectIds`または`assetIds`は必ず入力 | | `assetTypes` | Array | Optional | 検索するアセットタイプ (未設定時、すべてのアセットタイプで検索を実行) - `IMAGE` \| `VIDEO` - `IMAGE`: 画像 - `VIDEO`: ビデオ | | `indexModifiedFrom` | String | Optional | インデックス更新の開始日時 - ISO 8601形式 | | `indexModifiedTo` | String | Optional | インデックス更新の終了日時 - ISO 8601形式 | ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` { "query": { "textQuery": "暗い路地", "imageQuery": null, "personQuery": { "must": [101, 102], "any": [103], "not": [104] }, "dialogQuery": { "must": ["逃げろ"], "any": ["危ない"], "not": ["静かにしろ"] } }, "queryOption": { "confidenceLevel": "MEDIUM" }, "filter": { "projectIds": [201], "indexModifiedFrom": "2025-08-01T00:00:00Z", "indexModifiedTo": "2025-08-07T23:59:59Z" } } ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスボディ レスポンスボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `code` | String | - | [API処理結果コード](/docs/ja/maiu-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C) | | `message` | String | - | [API処理結果メッセージ](/docs/ja/maiu-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C) | | `result` | Object | - | 検索リクエスト結果情報 | | `result.searchId` | String | - | 作成されたアセット検索識別子 - [アセット検索結果照会 API](/docs/ja/maiu-get-asset-search-result)で使用 | ### レスポンス例 レスポンスのサンプルコードは次の通りです。 ``` { "code": "0", "message": "success", "result": { "searchId": "JtWJKTDCKknMHP8Id4Gt" } } ```