リストアセット

可用性

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

ノート

ゲートウェイは、プロバイダーの資産 ID、ステータス、およびユーザーの所有権を記録します。 Castaly ローカル ライブラリは、プロバイダー アセットの名前空間から分離されたままになります。

エンドポイント

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

認証

Modelflare API キーを使用します。

bash

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

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

リクエスト

オプションの名前、グループ、およびグループタイプのフィルターを使用してアセットをリストします。 Seedance リクエストで ID を使用する前に、Status: Active を待ってください。

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

JSON の例:

JSON

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

cURL の例:

bash

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

レスポンス

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

フィールド	タイプ	必須	説明	例
Items[]	object[]	いいえ	ID、タイプ、グループ、ステータス、プロジェクト、およびタイムスタンプを含む資産オブジェクト。	{ Id, Name, AssetType, GroupId, Status, ... }
Items[].Id / Name	string	いいえ	アセットの ID と表示名。	asset-20260528140922-d9646 / character-reference
Items[].AssetType / GroupId	string	いいえ	資産の種類と所有グループ。	Image / group-20260320141746-zsf6b
Items[].Status / ProjectName	string	いいえ	処理状態とプロジェクト名。	Active / default
Items[].CreateTime / UpdateTime	string	いいえ	ISO 8601 の作成および更新のタイムスタンプ。	2026-03-20T14:25:01Z
Items[].URL	string	いいえ	一時ファイルの URL。文書化された寿命は 12 時間です。生成リクエストには asset://<ID> を使用します。	https://example.com/temporary-asset
Items[].Error	object	いいえ	StatusがFailedの場合、CodeとMessageで処理エラーになります。	{ Code, Message }
PageNumber	integer	いいえ	ページ番号が返されました。	1
PageSize	integer	いいえ	返されたページサイズ。	10
TotalCount	integer	いいえ	一致する資産の合計。	2

応答例：

JSON

{
  "Items": [
    {
      "Id": "asset-20260528140922-d9646",
      "Name": "character-reference",
      "AssetType": "Image",
      "GroupId": "group-20260320141746-zsf6b",
      "Status": "Active",
      "ProjectName": "default"
    }
  ],
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1
}

エラー

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

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

JSON

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

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