ビデオと素材

マテリアルアセットグループの作成

Seedanceバーチャルアバターのマテリアルグループを作成します。

POST
/v1/videos/assets/groups

バーチャルアバター、製品、スタイル、その他本人確認を必要としない再利用可能な参照用の library_type: "aigc_avatar" マテリアルグループを作成します。group_name は任意(1〜128文字)、description も任意(最大500文字)です。リクエストが成功すると 201 が返されます。

このエンドポイントで本人確認用のグループを作成することはできません。library_type: "liveness_face" を指定すると 400 が返されます。本人確認用グループは、ビジュアルバリデーションを通じて作成してください。

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

リクエスト例

curl https://api.tokenlab.sh/v1/videos/assets/groups \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"library_type":"aigc_avatar","group_name":"Product references","description":"Reusable product shots","project_name":"default"}'

レスポンス例

{
  "id": "group-20260720123456-vrt01",
  "object": "seedance.material_asset_group",
  "project_name": "default",
  "library_type": "aigc_avatar",
  "group_name": "Product references",
  "description": "Reusable product shots",
  "status": "ACTIVE",
  "metadata": null,
  "created_at": 1782998400000,
  "updated_at": 1782998400000
}
curl -X POST "https://example.com/v1/videos/assets/groups" \  -H "Content-Type: application/json" \  -d '{    "library_type": "aigc_avatar",    "group_name": "Product references",    "description": "再利用可能な製品ショット"  }'
{  "id": "group-20260720123456-vrt01",  "object": "seedance.material_asset_group",  "library_type": "aigc_avatar",  "group_name": "Product references",  "description": "再利用可能な製品ショット",  "status": "ACTIVE",  "metadata": null,  "created_at": 1782998400000}

認証

BearerAuth
AuthorizationBearer <token>

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

場所: header

リクエストボディ

application/json

レスポンス

application/json

application/json

application/json

application/json

application/json

application/json