---
title: "Media Intelligenceの概要"
slug: "maiu-overview"
updated: 2026-10-08T07:12:37Z
published: 2026-10-08T07:12:37Z
canonical: "api.ncloud-docs.com/maiu-overview"
---

> ## 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.

# Media Intelligenceの概要

VPC環境で利用できます。

Media Intelligenceは、従来手動で操作していたメディア(映像、写真)分析を自動化した NAVERクラウドプラットフォームのメディア AI分析サービスです。Media Intelligenceサービスでは、プロジェクト管理、メディアアセットの管理および分析、インデックス管理に関する APIを RESTful形式で提供します。

## Media Intelligence共通設定

Media Intelligence APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

### リクエスト

共通リクエスト形式を説明します。

#### API URL

リクエスト API URLは次の通りです。

```
https://mi.apigw.ntruss.com
```

#### リクエストヘッダ

リクエストヘッダの説明は次の通りです。

| フィールド | 必須の有無 | 説明 |
| --- | --- | --- |
| `x-ncp-apigw-timestamp` | Required | 1970年1月1日00:00:00協定世界時(UTC)からの経過時間(ミリ秒) - API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす |
| `x-ncp-iam-access-key` | Required | NAVERクラウドプラットフォームから発行された Access Key - Access Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi)を参照 - サブアカウントの Access Key発行と確認: [サブアカウントの作成](https://guide.ncloud-docs.com/docs/ja/subaccount-use#%EC%84%9C%EB%B8%8C-%EA%B3%84%EC%A0%95-%EC%83%9D%EC%84%B1)を参照 |
| `x-ncp-apigw-signature-v2` | Required | NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64でエンコードした署名 - Secret Keyの発行と確認: [認証キーの作成](/docs/ja/common-ncpapi)を参照 - 署名の作成: [シグネチャーの作成](/docs/ja/common-ncpapi)を参照 |
| `Content-type` | Required | リクエストデータの形式 - `application/json` |

### レスポンス

共通レスポンス形式を説明します。

#### レスポンスボディ

レスポンスボディの説明は次の通りです。

**responseError**

responseErrorは API呼び出し失敗情報を定義します。responseErrorの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `code` | String | - | エラーコード |
| `message` | String | - | エラーメッセージ |

#### レスポンスステータスコード

レスポンスステータスコードの説明は次の通りです。

| HTTPステータスコード | コード | メッセージ | 説明 |
| --- | --- | --- | --- |
| 200 | 0 | success | リクエスト処理成功 |
| 400 | 10001 | Invalid Request. | リクエストパラメータエラー |
| 400 | 10014 | Select the asset you want to analyze. | 分析対象のメディアがない |
| 400 | 10016 | Select the bucket to integrate (folder selection not available). | フォルダ項目は登録不可 |
| 400 | 10023 | You can request up to 10 assets at a time. | 登録可能なメディア数を超過 (最大10個) |
| 400 | 10027 | The base project name can't be changed. | 基本プロジェクト名は変更不可 |
| 400 | 10033 | The base project can't be deleted. | 基本プロジェクトは削除不可 |
| 400 | 10041 | The bucket integration is invalid. Check the bucket information again in the NAVER Cloud Platform console. | 無効なバケット情報 (コンソールにて確認が必要) |
| 400 | 10046 | Failed to set object storage ACL. | Object Storage ACL設定失敗 |
| 400 | 10048 | Check the linked Object Storage settings | Object Storageファイルが存在しない |
| 400 | 50003 | Analyze result not exists. | 分析結果が存在しない |
| 400 | 50010 | Either projectIds or assetIds should be provided, not both. | projectIdsまたは assetIdsのいずれか一方のみ提供すること |
| 400 | 50011 | Either imageQuery or textQuery should be provided, not both. | imageQueryまたは textQueryのいずれか一方のみ提供すること |
| 400 | 50012 | Person query limit reached. You can only pass a maximum of 100 personIds at a time. | 人物 IDは一度に最大100個まで転送可能 |
| 400 | 50013 | Script query limit reached. You can only pass a maximum of 100 scripts at a time. | セリフは一度に最大100個まで転送可能 |
| 400 | 10069 | Please upload a large, clear image of your face, looking straight ahead. | 正面を向いた高解像度の顔画像をアップロードしてください |
| 400 | 10072 | Invalid file format. | 無効なファイル形式 |
| 400 | 10073 | Image crop error. | 画像切り抜きエラー |
| 400 | 10074 | Image cover upload failed. | 画像カバーアップロード失敗 |
| 400 | 10075 | Representative thumbnail not exist. | 代表サムネイルが存在しない |
| 400 | 10077 | Can not delete all thumbnails. | すべてのサムネイルを削除することができない |
| 400 | 10080 | Invalid merge source. | 統合対象リストに代表人物が含まれているか、既に統合された人物が含まれている |
| 400 | 10081 | Merge limit exceeded. | 統合対象の人物が最大数(10個)を超過 |
| 400 | 10082 | Thumbnail not found. | サムネイルキーが存在しない (アップロード前に呼び出されたか、24時間が経過して期限切れ) |
| 400 | 10083 | Face detection failed. | 画像から顔を検出できない (画像の画質が不十分) |
| 400 | 10084 | Multiple faces detected. | サムネイルに顔が2つ以上含まれている (顔1つだけの画像が必要) |
| 401 | 10003 | Failed to check permissions. | 権限確認失敗 |
| 404 | 10010 | The asset file does not exist. | メディアアセットファイルが存在しない |
| 404 | 10025 | The project does not exist. | プロジェクトが存在しない |
| 404 | 10030 | The workspace does not exist. | ワークスペースが存在しない |
| 404 | 10038 | Unanalyzed assets can't be canceled. | 分析されていないアセットはキャンセルできない |
| 404 | 40002 | The asset analysis job does not exist. | メディア分析ジョブが存在しない |
| 409 | 10026 | This project name already exists. | プロジェクト名が既に存在する |
| 409 | 10045 | Can create up to 1,000 items per workspace. | ワークスペースごとの最大作成可能数(1,000個)を超過 |
| 409 | 10049 | The project name exceeds the maximum length(100). | プロジェクト名が最大長さ(100文字)を超過 |
| 409 | 20012 | Exist Workspace Name. | 同一のワークスペース名が存在 |
| 409 | 10062 | Tag already registered. | タグは既に登録される |
| 409 | 10068 | You can register up to 500 items. | 最大登録数(500個)を超過 |
| 409 | 10076 | Primary thumbnail exceeded the limit. | 最大代表サムネイル数を超過 |
| 409 | 10085 | Person already merged. | 代表人物は既に統合処理済みの人物 |
| 409 | 50005 | The name is already in use. Please enter a different name. | 名前が既に使用されています。別の名前を入力してください |
| 422 | 10017 | Analyzing asset. | メディアアセットを分析中 |
| 422 | 10072 | Invalid file format. | 無効なファイル形式 |
| 422 | 10086 | Person has no feature. | 顔の特徴情報がない人物について、類似人物を照会 |
| 429 | 10087 | Reach quota limit. | APIごとの呼び出し制限を超過 |
| 500 | 99999 | An error has occurred. | 内部サーバエラー |

              参考

              

NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud APIのレスポンスステータスコード](/docs/ja/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

#### レスポンス例

呼び出しが成功した場合のレスポンス例は、API仕様書を確認してください。呼び出しに失敗した場合のレスポンスのサンプルコードは次の通りです。

```
{
    "code": "10001",
    "message": "Invalid request."
}
```

## Media Intelligence API

Media Intelligenceサービスが提供する APIの説明は次の通りです。

### プロジェクトの管理

| API | 説明 |
| --- | --- |
| [プロジェクトの作成](/docs/ja/maiu-create-projects) | メディアアセットと分析結果を管理するスペースであるプロジェクトを作成 |
| [プロジェクトリストの照会](/docs/ja/maiu-list-projects) | ワークスペースのプロジェクトリストを照会 |
| [プロジェクトの詳細照会](/docs/ja/maiu-project-details) | ワークスペースのプロジェクトの詳細情報を照会 |
| [プロジェクト情報の更新](/docs/ja/maiu-update-projects) | ワークスペースのプロジェクト情報を更新 |
| [プロジェクトの削除](/docs/ja/maiu-delete-projects) | ワークスペースからプロジェクトを削除 |

### メディアアセットの管理

| API | 説明 |
| --- | --- |
| [メディアアセットの登録](/docs/ja/mi-create-assets) | Object Storageバケットにアップロードしたファイルをプロジェクトに追加 |
| [メディアアセットリストの照会](/docs/ja/mi-list-assets) | プロジェクトのメディアアセットリストを照会 |
| [メディアアセットの詳細照会](/docs/ja/mi-asset-details) | プロジェクトのメディアアセットの詳細情報を照会 |
| [メディアアセット登録状態の照会](/docs/ja/mi-asset-status) | プロジェクトに登録したメディアアセットの状態を照会 |
| [メディアアセットのプロジェクト移動](/docs/ja/mi-move-assets) | メディアアセットを別のプロジェクトに移動 |
| [メディアアセットの削除](/docs/ja/mi-delete-assets) | プロジェクトからメディアアセットを削除 |

### インデックスの管理

アセットごとに最新のインデックスを1件運用するモデルに基づき、インデックス IDを指定せずに、アセット単位で分析・照会・削除を行います。

| API | 説明 |
| --- | --- |
| [メディアアセット分析のリクエスト](/docs/ja/mi-request-index) | メディアアセットを分析し、最新のインデックスを作成 |
| [インデックスの照会](/docs/ja/mi-get-index) | メディアアセットの最新のインデックスの詳細情報を照会 |
| [メディアアセット分析状態の照会](/docs/ja/mi-index-status) | メディアアセットの最新の分析進行状況を照会 |
| [メディアアセット分析のキャンセル](/docs/ja/mi-cancel-index) | 待機中または実行中の分析をキャンセル |
| [インデックスの削除](/docs/ja/mi-delete-index) | メディアアセットの最新のインデックスを削除 |

### シーン要約

| API | 説明 |
| --- | --- |
| [シーン要約のリクエスト](/docs/ja/mi-request-scene-summary) | 最新のインデックスを対象に VLMベースのシーン要約をリクエスト |
| [シーン要約状態の照会](/docs/ja/mi-scene-summary-status) | シーン要約の進捗状況を照会 |
| [シーン要約のキャンセル](/docs/ja/mi-cancel-scene-summary) | 待機中または実行中のシーン要約をキャンセル |
| [シーン要約結果の照会](/docs/ja/mi-get-scene-summary-result) | アセットの最新のシーンごとの要約結果データを照会 |

### シーン要約の活用

| API | 説明 |
| --- | --- |
| [シーン要約活用変換のリクエスト](/docs/ja/mi-request-transformation) | 最新のシーン要約に基づく、目的別の変換テキスト・シーンメタデータの作成リクエスト |
| [シーン要約活用変換結果の照会](/docs/ja/mi-get-transformation-result) | 変換の進行状況およびプリセットごとの変換結果を照会 |

### 人物タブ管理

| API | 説明 |
| --- | --- |
| [人物タグの登録](/docs/ja/maiu-create-person-tags) | ワークスペースに人物タグを登録 |
| [人物タグリストの照会](/docs/ja/maiu-list-person-tags) | ワークスペースの人物タグリストを照会 |
| [人物タグの削除](/docs/ja/maiu-delete-person-tags) | ワークスペースから人物タグを削除 |

### 人物管理

人物の照合は、用途に応じて詳細照会、簡易リスト照会、複合条件照会に分類されて提供されます。

| API | 説明 |
| --- | --- |
| [人物の登録](/docs/ja/maiu-create-persons) | ワークスペースに新規人物を登録 (名前を入力しない場合、匿名人物として登録) |
| [人物の詳細照会](/docs/ja/maiu-person-details) | 人物の詳細情報を照会 |
| [人物リストの照会](/docs/ja/maiu-list-persons) | ワークスペースの人物リストを照会 |
| [人物の検索](/docs/ja/mi-search-persons) | 人物 ID・タグ・命名状態・ソート基準などの複合条件で人物を検索 |
| [人物情報の更新](/docs/ja/maiu-update-persons) | 人物名、説明などの情報を更新 |
| [人物更新タグの設定](/docs/ja/maiu-add-person-tags) | 人物にタグを設定 |
| [人物更新タグの削除](/docs/ja/maiu-remove-person-tags) | 人物からタグを削除 (`DELETE`方式) |
| [人物タグの削除](/docs/ja/mi-remove-person-tags) | 人物からタグを削除 (`POST`方式) |
| [人物更新サムネイルの設定](/docs/ja/maiu-set-person-thumbnail) | 人物サムネイルを設定 |
| [人物更新サムネイルの削除](/docs/ja/maiu-remove-person-thumbnail) | 人物サムネイルを削除 (`DELETE`方式) |
| [人物サムネイルの削除](/docs/ja/mi-remove-person-thumbnail) | 人物サムネイルを削除 (`POST`方式) |
| [人物の統合](/docs/ja/mi-merge-persons) | 同一人物と判断された複数の人物を代表人物として統合 |
| [類似人物の照会](/docs/ja/mi-similar-persons) | 指定した人物と顔が似ている人物を、類似度順に照会 |
| [人物の照合](/docs/ja/mi-recommend-persons-by-thumbnail) | アップロードしたサムネイルに基づいて、類似した登録人物を推薦 |
| [人物の削除](/docs/ja/maiu-delete-persons) | ワークスペースから人物を削除 |
| [サムネイル Presigned URLの発行](/docs/ja/maiu-upload-person-thumbnail-url) | 人物サムネイルアップロードのための Presigned URLを発行 |
| [サムネイルアップロード状態の照会](/docs/ja/maiu-upload-person-thumbnail-status) | サムネイルアップロード完了状態を照会 |

### シーンの検索

| API | 説明 |
| --- | --- |
| [検索アセット Presigned URLの発行](/docs/ja/maiu-upload-asset-query-url) | シーン検索のためのクエリアセットアップロード Presigned URLを発行 |
| [検索アセットアップロード状態の照会](/docs/ja/maiu-upload-asset-query-status) | アップロードされたクエリアセットのアップロードは完了したか確認 |
| [アセット検索のリクエスト](/docs/ja/maiu-search-asset) | メディアアセットで条件に合ったシーン、画像を検索 |
| [アセット検索結果の照会](/docs/ja/maiu-get-asset-search-result) | シーン検索リクエストの結果(シーン、画像リスト)を照会 |

### ワークスペース管理

| API | 説明 |
| --- | --- |
| [ワークスペースの作成](/docs/ja/maiu-create-workspaces) | ワークスペースを新規作成 |
| [ワークスペースリストの照会](/docs/ja/maiu-list-workspaces) | アカウント内ワークスペースリストを照会 |
| [ワークスペースの詳細照会](/docs/ja/maiu-workspace-details) | ワークスペースの詳細情報を照会 |
| [ワークスペースの削除](/docs/ja/maiu-delete-workspaces) | ワークスペースを削除 |

## Media Intelligence関連リソース

Media Intelligence APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。

- Media Intelligence APIの使用方法
  - [署名(シグネチャー)の作成](/docs/ja/common-ncpapi#%EC%8B%9C%EA%B7%B8%EB%8B%88%EC%B2%98%EC%83%9D%EC%84%B1): リクエストヘッダに追加する署名の作成方法
  - [API Gatewayご利用ガイド](https://guide.ncloud-docs.com/docs/ja/apigw-apigw-1): リクエストヘッダに追加する API Keyを発行
  - [Sub Accountご利用ガイド](https://guide.ncloud-docs.com/docs/ja/subaccount-overview): リクエストヘッダに追加する Access Keyの発行方法
  - [Ncloudの共通レスポンスステータスコード](/docs/ja/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C): Media Intelligenceサービスで使用される NAVERクラウドプラットフォームの共通レスポンスステータスコード情報
- Media Intelligenceサービスの使用方法
  - [Media Intelligenceご利用ガイド](https://guide.ncloud-docs.com/docs/ja/maiu-overview): NAVERクラウドプラットフォームコンソールにて Media Intelligenceを使用する方法
  - [Ncloud利用環境ガイド](https://guide.ncloud-docs.com/docs/ja/environment-environment-1-1): VPC、Classic環境およびサポートに関する利用ガイド
  - [料金の紹介、特徴、詳細機能](https://www.ncloud.com/product/media/mediaAIUnderstanding): Media Intelligenceの料金体系、特徴、詳細機能のサマリー
  - [サービスの最新情報](https://www.ncloud.com/intro/news?categoryCode=MEDIA): Media Intelligenceに関する最新情報
  - [よくある質問](https://www.ncloud.com/support/faq/prod?categoryCode2=MEDIA&categoryCode3=SV_0274&page=1): Media Intelligenceユーザーからよく寄せられる質問とその回答
  - [お問い合わせ](https://www.ncloud.com/support/question/service): APIガイドだけでは不明な点が解消されない場合、直接問い合わせ