ビデオアセットの登録

Prev Next

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

VPC環境で利用できます。

Object Storageバケットにアップロードしたビデオファイルをプロジェクトに追加します。

maiu-create-assets_workflow

リクエスト

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

メソッド URI
POST /api/v1/workspaces/{workspace_name}/projects/{project_id}/video-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
  • <例>sample-video.mp4
bucketName String Required Object Storageバケット名

リクエスト例

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

curl --location --request POST 'https://maiu.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.videoId 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": {
        "videoId": 1234,
        "createUserName": "username",
        "createdTime": "2025-04-23T16:49:23.885456721",
        "updateUserName": "username",
        "updatedTime": "2025-04-23T16:49:23.885456721"
    }
}