メディアアセットの登録

Prev Next

VPC環境で利用できます。

Object Storageバケットにアップロードしたメディアファイルをプロジェクトに追加します。
メディア分析は、メディアアセットの登録完了が確認された後に実行できます。詳細は、下部のワークフロー図から確認できます。

maiu-create-assets_workflow

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
POST /api/v1/workspaces/{workspace_name}/projects/{project_id}/assets/import/object-storage

リクエストヘッダ

Media Intelligence APIで共通して使用されるヘッダの詳細は、Media Intelligenceのリクエストヘッダをご参照ください。

リクエストパスパラメータ

パラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
workspace_name String Required ワークスペース名
project_id String Required プロジェクト ID

リクエストボディ

リクエストボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
key String Required Object Storageにアップロードしたメディアファイルのフルネーム
  • 動画分析をサポートする形式
    • 解像度: 360p~1080p (推奨は720p)
    • 長さ: 6時間
    • ファイルサイズ: 10GB
    • ファイル形式: MP4、MKV、MOV、WebM
  • 画像分析をサポートする形式
    • 解像度: 最小360p、最大1080p
    • ファイルサイズ: 10MB
    • ファイル形式: JPG、PNG、HEIC (HEICファイルは JPGファイルへの変換プロセスが必要であり、分析時間が長くなる可能性があります)
  • <例>sample-video.mp4image.png
bucketName String Required Object Storageバケット名

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request POST 'https://mi.apigw.ntruss.com/api/v1/workspaces/my-workspace/projects/1234/video-assets/import/object-storage' \
--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' \
--data '{
  "key": "sample-video.mp4",
  "bucketName": "my-storage-bucket"
}'

レスポンス

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

レスポンスボディ

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

フィールド タイプ 必須の有無 説明
code String Required API処理結果コード
message String Required API処理結果メッセージ
result Object Required メディアアセットの詳細情報
result.assetId Integer Required メディアアセット ID
result.createUserName String Required メディアアセットを登録したユーザー名
result.createdTime String Required メディアアセットの登録日時
  • ISO 8601形式
result.updateUserName String Required メディアアセットを最後に更新したユーザー名
result.updatedTime String Required メディアアセットの最終更新日時
  • ISO 8601形式

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "code": "0",
    "message": "success",
    "result": {
        "assetId": 1234,
        "createUserName": "username",
        "createdTime": "2025-04-23T16:49:23.885456721",
        "updateUserName": "username",
        "updatedTime": "2025-04-23T16:49:23.885456721"
    }
}