プロジェクトの作成

Prev Next

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

VPC環境で利用できます。

ビデオアセットと分析結果を管理するスペースであるプロジェクトを作成します。

参考

プロジェクトはワークスペースごとに最大1,000個まで作成できます。

リクエスト

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

メソッド URI
POST /api/v1/workspaces/{workspace_name}/projects

リクエストヘッダ

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

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

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

フィールド タイプ 必須の有無 説明
workspace_name String Required ワークスペース名

リクエストボディ

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

フィールド タイプ 必須の有無 説明
name String Required プロジェクト名
  • 英数字、記号を組み合わせて100文字以内で入力
    • セミコロン(;)、バーティカルバー(\|)、バッククォート(`)は使用不可
  • ワークスペース内では重複不可

リクエスト例

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

curl --location --request POST 'https://maiu.apigw.ntruss.com/api/v1/workspaces/my-workspace/projects' \
--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 '{
    "name": "project_name"
}'

レスポンス

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

レスポンスボディ

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

フィールド タイプ 必須の有無 説明
code String Required API処理結果コード
message String Required API処理結果メッセージ
result Object Required プロジェクトの詳細情報
result.projectId Integer Required プロジェクト ID
result.name String Required プロジェクト名
result.isBaseProject Boolean Required 基本プロジェクトかどうか
  • true | false
result.createdUserName String Required プロジェクトを作成したユーザー名
result.createdTime String Required プロジェクトの作成日時
  • ISO 8601形式
result.updatedUserName String Required プロジェクトを最後に更新したユーザー名
result.updatedTime String Required プロジェクトの最終更新日時
  • ISO 8601形式

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

Media AI Understanding APIで共通して使用されるレスポンスステータスコードの詳細は、Media AI Understandingのレスポンスステータスコードをご参照ください。

レスポンス例

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

{
    "code": "0",
    "message": "success",
    "result": {
        "projectId": 1234,
        "name": "project_name",
        "isBaseProject": false,
        "createdUserName": "username",
        "createdTime": "2025-04-23T14:15:19.563829873",
        "updatedUserName": "username",
        "updatedTime": "2025-04-23T14:15:19.56389036"
    }
}