アセットグループの一覧表示

可用性

このページには、Modelflare の資産管理ルートが記載されています。呼び出しには、有効なスマート API キーまたはメディアグループ API キー、使用可能なメディアチャネル、および必要な権限が必要です。

エンドポイント

POST https://modelflare.dev/volc/asset/ListAssetGroups

認証

Modelflare API キーを使用します。

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

作成、更新、削除リクエストを含む Idempotency-Key を送信します。同じユーザーに対して同じキーを再試行すると、ミューテーションを繰り返さずに、保存された応答が再生されます。

リクエスト

オプションの名前、ID、グループタイプフィルターを使用してグループをリストします。読み取りには生成料金がかかりません。

フィールド	タイプ	必須	説明	例
`model`	`string`	はい	課金モデル。初期値は`volc-asset`です。	`volc-asset`
`Filter.Name`	`string`	いいえ	あいまいな名前のフィルター。	`my-project`
`Filter.GroupIds`	`string[]`	いいえ	グループ ID のリストによる正確なフィルター。	`["group-20260320141746-zsf6b"]`
`Filter.Id`	`string`	いいえ	1 つのグループ ID による正確なフィルター。	`group-20260320141746-zsf6b`
`Filter.GroupType`	`AIGC`	`LivenessFace`	いいえ	グループタイプでフィルタリングします。
`PageNumber`	`integer`	いいえ	ページ番号。初期値は`1`です。	`1`
`PageSize`	`integer`	いいえ	ページごとの項目。初期値は`10`です。	`10`

JSON の例:

{
  "model": "volc-asset",
  "Filter": {
    "Name": "my-project",
    "GroupIds": [
      "group-20260320141746-zsf6b"
    ],
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}

cURL の例:

curl --request POST https://modelflare.dev/volc/asset/ListAssetGroups \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "volc-asset",
  "Filter": {
    "Name": "my-project",
    "GroupIds": [
      "group-20260320141746-zsf6b"
    ],
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}'

レスポンス

リクエストは成功しました。

フィールド	タイプ	必須	説明	例
`Items[]`	`object[]`	いいえ	`Id`、`Name`、`GroupType`、および `Status` のアセットグループ。	`{ Id, Name, GroupType, Status }`
`Items[].Id / Name`	`string`	いいえ	グループ ID と表示名。	`group-20260320141746-zsf6b / my-project-assets`
`Items[].GroupType / Status`	`string`	いいえ	グループのタイプと現在の状態。	`AIGC / Active`
`PageNumber`	`integer`	いいえ	ページ番号が返されました。	`1`
`PageSize`	`integer`	いいえ	返されたページサイズ。	`10`
`TotalCount`	`integer`	いいえ	一致するグループの合計。	`1`

応答例：

{
  "Items": [
    {
      "Id": "group-20260320141746-zsf6b",
      "Name": "my-project-assets",
      "GroupType": "AIGC",
      "Status": "Active"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1
}

エラー

ステータス	意味
`400`	リクエストは無効です。
`401`	API キーが見つからないか、または不正です。

エラー本文の例 (返された場合):

{
  "error": {
    "code": "invalid_request",
    "message": "Request validation failed."
  }
}

画像、ビデオ、オーディオの作成は非同期です。アセット ID を受信後、ステータスが Active の場合にのみ、GetAsset を呼び出し、asset://<ID> 参照を使用します。