ビデオと素材

マテリアルアセットグループの一覧取得

現在の組織が所有するSeedanceマテリアルグループを一覧表示します。

GET
/v1/videos/assets/groups

認証された組織が所有するマテリアルグループを一覧表示します。library_type および status でフィルタリングすることで、バーチャルアバターグループと実在人物グループを分離できます。

status には ACTIVE または DELETED を指定可能です。page_size は1〜100(デフォルトは20)を指定できます。次のページを読み込むには、レスポンスから取得した next_page_token を page_token として渡してください。

マテリアルをアップロードする際は、返された id を使用してください。動画生成時に group_id を material_asset_id として渡さないでください。生成にはマテリアルアセットの id が必要です。

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

リクエスト例

curl "https://api.tokenlab.sh/v1/videos/assets/groups?library_type=aigc_avatar&page_size=20&project_name=default" \
  -H "Authorization: Bearer $TOKENLAB_API_KEY"

レスポンス例

{
  "groups": [
    {
      "id": "group-20260720123456-vrt01",
      "object": "seedance.material_asset_group",
      "project_name": "default",
      "library_type": "aigc_avatar",
      "group_name": "Product references",
      "status": "ACTIVE",
      "created_at": 1782998400000,
      "updated_at": 1782998400000
    }
  ],
  "next_page_token": null
}
curl -X GET "https://example.com/v1/videos/assets/groups"
{  "groups": [    {      "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    },    {      "id": "group-20260720123456-real1",      "object": "seedance.material_asset_group",      "library_type": "liveness_face",      "group_name": "Creator A",      "description": null,      "status": "ACTIVE",      "metadata": null,      "created_at": 1782998400000    }  ],  "next_page_token": null}

認証

BearerAuth
AuthorizationBearer <token>

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

場所: header

クエリパラメータ

page_size?integer
範囲1 <= value <= 100
デフォルト20
page_token?string
status?string

指定できる値

  • "ACTIVE"
  • "DELETED"
library_type?string

TokenLabマテリアルライブラリクラスでフィルタリングします。

指定できる値

  • "aigc_avatar"
  • "liveness_face"
project_name?string

素材リソースのプロジェクトスコープ。

長さ1 <= length <= 128
デフォルト"default"

レスポンス

application/json

application/json

application/json

application/json