ビデオと素材

マテリアルアセットグループの更新

現在の組織が所有するSeedanceマテリアルグループを更新します。

PUT
/v1/videos/assets/groups/{groupId}

マテリアルグループの表示名(group_name)、description、または metadata を更新します。これらのうち少なくとも1つを送信してください。送信されない場合、リクエストは 400 を返します。実在の人物グループは、検証済みの人物マッピングを保持します。グループ内のマテリアルがまだ準備中の場合、リクエストは 409 を返すことがあります。その場合は少し時間を置いて再試行してください。

project_name は組織内のリソースをスコープ分けするもので、デフォルトは default です。関連するグループやアセットには、大文字と小文字を区別した同じ値を指定してください。POST/PUTの場合はJSONボディに、GET/DELETEの場合はクエリ文字列に含めて送信します。

リクエスト例

curl https://api.tokenlab.sh/v1/videos/assets/groups/group-20260720123456-vrt01 \
  -X PUT \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"group_name":"Updated references","description":"Images approved for summer videos","project_name":"default"}'

レスポンス例

{
  "id": "group-20260720123456-vrt01",
  "object": "seedance.material_asset_group",
  "project_name": "default",
  "library_type": "aigc_avatar",
  "group_name": "Updated references",
  "description": "Images approved for summer videos",
  "status": "ACTIVE",
  "metadata": null,
  "created_at": 1782998400000,
  "updated_at": 1782998400000
}
curl -X PUT "https://example.com/v1/videos/assets/groups/group-20260720123456-vrt01" \  -H "Content-Type: application/json" \  -d '{    "group_name": "Updated references",    "description": "夏の動画用に承認された画像"  }'
{  "id": "group-20260720123456-vrt01",  "object": "seedance.material_asset_group",  "library_type": "aigc_avatar",  "group_name": "Updated references",  "description": "夏の動画用に承認された画像",  "status": "ACTIVE",  "metadata": null,  "created_at": 1782998400000}

認証

BearerAuth
AuthorizationBearer <token>

APIキー認証。Dashboard > API > API KeysでAPIキーを作成または管理します。

場所: header

パスパラメータ

groupId*string

リクエストボディ

application/json

レスポンス

application/json

application/json

application/json

application/json

application/json

application/json

application/json