Media AI Understandingの概要

Prev Next

最新のコンテンツが反映されていません。早急にアップデート内容をご提供できるよう努めております。最新のコンテンツ内容は韓国語ページをご参照ください。

VPC環境で利用できます。

Media Intelligenceサービスは、従来手動で操作していた映像分析を自動化した NAVERクラウドプラットフォームのメディア AI分析ソリューションです。Media Intelligenceサービスは、プロジェクト管理、ビデオアセットの管理・分析、インデックス管理関連の APIを RETSTful形式で提供します。

Media Intelligenceの共通設定

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

リクエスト

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

API URL

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

https://maiu.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の発行と確認: 認証キーの作成を参照
  • サブアカウントの Access Key発行と確認: サブアカウントの作成を参照
    		•
    x-ncp-apigw-signature-v2 Required NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64にエンコードした署名
  • Secret Keyの発行と確認: 認証キーの作成を参照
  • 署名の作成: シグネチャーの作成を参照
    		•
    Content-type Required リクエストデータの形式
  • application/json
    		•

    レスポンス

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

    レスポンスボディ

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

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

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

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

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

    HTTPステータスコード コード メッセージ 説明
    200 0 success リクエスト処理成功
    400 10001 Invalid Request. リクエストパラメータエラー
    400 10014 Select the video you want to analyze. 分析対象のビデオがない
    400 10016 Select the bucket to integrate (folder selection not available). ディレクトリ項目は登録不可
    400 10023 You can request up to 10 videos 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. NAVERクラウドプラットフォームコンソールのバケットが有効ではない
    400 10046 Failed to set object storage ACL. NAVERクラウドプラットフォームコンソールのバケットが有効ではない
    400 10048 Check the linked Object Storage settings Object Storageファイルが存在しない
    400 50003 Analyze result not exists. ディレクトリ項目は登録不可
    401 10003 Failed to check permissions. 権限確認失敗
    404 10010 The video file does not exist. 映像ファイルなし
    404 10025 The project does not exist. プロジェクトなし
    404 10030 The workspace does not exist. ワークスペースなし
    404 10038 Unanalyzed videos can't be canceled. 分析していない映像はキャンセル不可
    404 40002 The video analysis job does not exist. 映像分析ジョブなし
    409 10026 This project name already exists. プロジェクト名が重複している
    409 10045 Can create up to 1,000 items per workspace. ワークスペースで作成可能なプロジェクトの最大数超過
    409 10049 The project name exceeds the maximum length(100). プロジェクト名の長さ超過
    409 20012 Exist Workspace Name. ワークスペース名が重複している
    422 10017 Analyzing video. 映像分析中
    500 99999 An error has occurred. 内部サーバエラー
    参考

    NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。

    レスポンス例

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

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

    Media Intelligence API

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

    プロジェクトの管理

    API 説明
    プロジェクトの作成 ビデオアセットと分析結果を管理するスペースであるプロジェクトを作成
    プロジェクトリストの照会 ワークスペースのプロジェクトリストを照会
    プロジェクトの詳細照会 ワークスペースのプロジェクトの詳細情報を照会
    プロジェクト情報の更新 ワークスペースのプロジェクト情報を更新
    プロジェクトの削除 ワークスペースからプロジェクトを削除

    ビデオアセットの管理

    API 説明
    ビデオアセットの登録 Object Storageバケットにアップロードした映像ファイルをプロジェクトに追加
    ビデオアセットリストの照会 プロジェクトのビデオアセットリストを照会
    ビデオアセットの詳細照会 プロジェクトのビデオアセットの詳細情報を照会
    ビデオアセット登録状態の照会 プロジェクトに登録したビデオアセットの状態を照会
    ビデオアセットのプロジェクト移動 ビデオアセットを別のプロジェクトに移動
    ビデオアセットの削除 プロジェクトからビデオアセットを削除

    ビデオアセットの分析

    API 説明
    ビデオアセット分析のリクエスト ビデオアセットを分析し、映像分析結果であるインデックスを作成
    ビデオアセット分析状態の照会 プロジェクトに登録したビデオアセットの分析状態を照会
    ビデオアセット分析のキャンセル 実行中ビデオアセット分析リクエストをキャンセル

    インデックスの管理

    API 説明
    インデックスリストの照会 ビデオアセットのインデックスリストを照会
    インデックスの詳細照会 ビデオアセットのインデックスの詳細情報を照会
    インデックスの削除 ビデオアセットのインデックスを削除

    Media Intelligence関連リソース

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