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

リクエスト
リクエスト形式を説明します。リクエスト形式は次の通りです。
| メソッド | 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にアップロードしたメディアファイルのフルネーム
|
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 | メディアアセットの登録日時
|
result.updateUserName |
String | Required | メディアアセットを最後に更新したユーザー名 |
result.updatedTime |
String | Required | メディアアセットの最終更新日時
|
レスポンス例
レスポンスのサンプルコードは次の通りです。
{
"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"
}
}