TokenLab
API キーを取得
ドキュメントAPIリファレンス連携

ビデオと素材

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

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

GET
/v1/videos/assets/groups

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

マテリアルをアップロードする際は、返された 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
    }
  ],
  "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

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

前へ

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

次へ