--- title: "インデックスの詳細照会 (Deprecated)" slug: "maiu-index-details" updated: 2026-09-17T09:58:08Z published: 2026-09-17T09:58:08Z canonical: "api.ncloud-docs.com/maiu-index-details" --- > ## 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. # インデックスの詳細照会 (Deprecated) VPC環境で利用できます。 注意 この APIは非推奨となっており(deprecated)、2027年1月に削除される予定です。アセットごとに最新のインデックスを1件照会する新規の[インデックスの照会](/docs/ja/mi-get-index) APIをご利用ください。 メディアアセットのインデックスの詳細情報を照会します。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | GET | /api/v1/workspaces/{workspace_name}/projects/{project_id}/assets/{asset_id}/indexes/{index_id} | ### リクエストヘッダ Media Intelligence APIで共通して使用されるヘッダの詳細は、[Media Intelligenceのリクエストヘッダ](/docs/ja/maiu-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 ### リクエストパスパラメータ リクエストパスパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `workspace_name` | String | Required | ワークスペース名 | | `project_id` | String | Required | プロジェクト ID - [プロジェクトリストの照会](/docs/ja/maiu-list-projects)を参照 | | `asset_id` | String | Required | メディアアセット ID - [メディアアセットリストの照会](/docs/ja/mi-list-assets)を参照 | | `index_id` | String | Required | インデックス ID - [インデックスリストの照会](/docs/ja/maiu-list-indexes)を参照 | ### リクエストクエリパラメータ リクエストクエリパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `confidence_level` | String | Optional | 信頼度に基づいた絞り込み条件 - `LOW` \| `MEDIUM` (デフォルト) \| `HIGH` - `LOW`: 信頼度が低い検出結果を表示(より多くのキーワードを抽出) - `MEDIUM`: 信頼度が中の検出結果を表示(適度なキーワードを抽出) - `HIGH`: 信頼度が高い検出結果を表示(正確なキーワードを抽出) | ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` curl --location --request GET 'https://mi.apigw.ntruss.com/api/v1/workspaces/my-workspace/projects/1234/assets/5678/indexes/1001?confidence_level=MEDIUM' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \ --header 'Content-Type: application/json' ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスボディ レスポンスボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `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.indexId` | Integer | - | インデックス ID | | `result.type` | String | - | アセットのタイプ - `IMAGE` \| `VIDEO` | | `result.createdTime` | String | - | インデックスの作成日時 - ISO 8601形式 | | `result.createdUserName` | String | - | インデックスを作成したユーザー名 | | `result.updatedTime` | String | - | インデックスの最終更新日時 - ISO 8601形式 | | `result.updatedUserName` | String | - | インデックスを最後に更新したユーザー名 | | `result.analysisSetting` | Object | - | 分析設定情報 | | `result.analysisSetting.analysisEngine` | String | - | 分析エンジンバージョン - 例: `v3.2` | | `result.analysisSetting.sceneRange` | String | Optional | (ビデオ分析時)自動的に分割されるシーンの長さ - `SHORT` \| `MEDIUM` (デフォルト) \| `LONG` - 画像アセットは nullと表示 - `minSceneDurationSec`/`maxSceneDurationSec`で分析した場合、nullと表示 | | `result.analysisSetting.minSceneDurationSec` | Integer | Optional | (ビデオ分析時)分析リクエスト時に設定した最小シーン長 (秒) - `sceneRange`で分析した場合、nullと表示 - 画像アセットは nullと表示 | | `result.analysisSetting.maxSceneDurationSec` | Integer | Optional | (ビデオ分析時)分析リクエスト時に設定した最大シーン長 (秒) - `sceneRange`で分析した場合、nullと表示 - 画像アセットは nullと表示 | | `result.analysisSetting.analysisPersonCount` | Integer | - | 分析時に検出する人物の数 | | `result.analysisSetting.sourceLanguage` | String | - | 分析対象となる元のビデオの言語情報 - `KO` (デフォルト) \| `ENKO` \| `EN` \| `JA` \| `ZH-CN` \| `ZH-TW` | | `result.analysisSetting.detectAudioEffects` | Boolean | Optional | (ビデオ分析時)音声効果を追加するか - `true` \| `false` (デフォルト) | | `result.indexDetails` | Object | - | インデックス内容情報 | | `result.indexDetails.durationMs` | Integer | Optional | (ビデオ分析時)ビデオの長さ (ミリ秒) - 画像アセットは0と表示 | | `result.indexDetails.fps` | Integer | Optional | (ビデオ分析時)1秒当たりのフレーム数 - 画像アセットは0と表示 | | `result.indexDetails.frameCount` | Integer | Optional | (ビデオ分析時)フレームの総数 - 画像アセットは0と表示 | | `result.indexDetails.assetUrl` | String | - | メディアアセットソース URL | | `result.indexDetails.segments` | Array | - | [セグメントリスト](/docs/ja/maiu-index-details#%EC%84%B8%EA%B7%B8%EB%A8%BC%ED%8A%B8%EB%AA%A9%EB%A1%9D) | #### result.indexDetails.segments | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `start` | Integer | Optional | (ビデオ分析時)セグメント開始フレーム番号。画像アセットは0 | | `end` | Integer | Optional | (ビデオ分析時)セグメント終了フレーム番号。画像アセットは0 | | `startMs` | Integer | Optional | (ビデオ分析時)セグメント開始時間(ミリ秒)。画像アセットは0 | | `endMs` | Integer | Optional | (ビデオ分析時)セグメント終了時間(ミリ秒)。画像アセットは0 | | `scene` | Integer | Optional | (ビデオ分析時)シーン番号。画像アセットは0 | | `shot` | Integer | Optional | (ビデオ分析時)ショット番号。画像アセットは0 | | `sceneThumbnailUrl` | String | Optional | (ビディ分析時)サムネイル画像 URL (有効時間は1時間) | | `speeches` | Array | Optional | 発話情報 | | `keywords` | Array | - | キーワード情報 | | `people` | Array | - | 登場人物情報 | ### レスポンスステータスコード Media Intelligence APIで共通して使用されるレスポンスステータスコードの詳細は、[Media Intelligenceのレスポンスステータスコード](/docs/ja/maiu-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 **プリセットで分析したインデックス** ``` { "code": "0", "message": "success", "result": { "indexId": 1001, "type": "VIDEO", "createdTime": "2025-04-24T16:42:00", "createdUserName": "username", "updatedTime": "2025-04-24T16:43:08", "updatedUserName": "username", "analysisSetting": { "analysisEngine": "v3.2", "sceneRange": "MEDIUM", "minSceneDurationSec": null, "maxSceneDurationSec": null, "analysisPersonCount": 2, "sourceLanguage": "KO", "detectAudioEffects": true }, "indexDetails": { "durationMs": 20054, "fps": 29.97, "frameCount": 601, "assetUrl": "https://kr.object.ncloudstorage.com/maiu-my-storage/videos/1234/interview.mp4", "segments": [ { "start": 0, "end": 275, "startMs": 0, "endMs": 9176, "scene": 1, "shot": 1, "sceneThumbnailUrl": "https://kr.object.ncloudstorage.com/.../1234/1.jpg?X-Amz-...", "speeches": [ { "id": 180080, "startMs": 679, "endMs": 10195, "text": "平素は NAVERクラウドプラットフォームをご利用いただき、誠にありがとうございます。本日はインタビューにご協力いただき、ありがとうございます。", "pid": "1", "name": "話者1" } ], "keywords": [ { "category": "行動", "group": "事務/オーフィス/イベント", "text": "ニュースキャスター", "score": 87.23 } ], "people": [] } ] } } } ``` **シーンの長さを直接指定して分析したインデックス** ``` { "code": "0", "message": "success", "result": { "indexId": 1002, "type": "VIDEO", "createdTime": "2025-04-24T16:42:00", "createdUserName": "username", "updatedTime": "2025-04-24T16:43:08", "updatedUserName": "username", "analysisSetting": { "analysisEngine": "v3.2", "sceneRange": null, "minSceneDurationSec": 15, "maxSceneDurationSec": 60, "analysisPersonCount": 2, "sourceLanguage": "KO", "detectAudioEffects": false }, "indexDetails": { "durationMs": 20054, "fps": 29.97, "frameCount": 601, "assetUrl": "https://kr.object.ncloudstorage.com/maiu-my-storage/videos/1234/interview.mp4", "segments": [] } } } ```