Buat daftar grup aset

Ketersediaan

Halaman ini mendokumentasikan rute manajemen aset Modelflare. Panggilan memerlukan Kunci API Cerdas atau kunci API grup media yang valid, saluran media yang tersedia, dan izin yang diperlukan.

Catatan

Gateway mencatat ID aset penyedia, status, dan kepemilikan pengguna. Perpustakaan lokal Castaly tetap terpisah dari namespace aset penyedia.

Titik akhir

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

Otentikasi

Gunakan kunci API Modelflare:

bash

-H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Kirim Idempotency-Key dengan permintaan buat, perbarui, dan hapus. Mencoba kembali kunci yang sama untuk pengguna yang sama akan memutar ulang respons yang disimpan tanpa mengulangi mutasi.

Permintaan

Daftar grup dengan nama opsional, ID, dan filter jenis grup. Pembacaan tidak dikenakan biaya pembangkitan.

Bidang	Ketik	Wajib diisi	Deskripsi	Contoh
model	string	Ya	Model penagihan. Defaultnya adalah volc-asset.	volc-asset
Filter.Name	string	Tidak	Filter nama kabur.	my-project
Filter.GroupIds	string[]	Tidak	Filter yang tepat berdasarkan daftar ID grup.	["group-20260320141746-zsf6b"]
Filter.Id	string	Tidak	Filter persis berdasarkan satu ID grup.	group-20260320141746-zsf6b
Filter.GroupType	AIGC	LivenessFace	Tidak	Filter berdasarkan jenis grup.
PageNumber	integer	Tidak	Nomor halaman. Defaultnya adalah 1.	1
PageSize	integer	Tidak	Item per halaman. Defaultnya adalah 10.	10

Contoh JSON:

JSON

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

cURL contoh:

bash

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
}'

Tanggapan

Permintaan berhasil.

Bidang	Ketik	Wajib diisi	Deskripsi	Contoh
Items[]	object[]	Tidak	Grup aset dengan Id, Name, GroupType, dan Status.	{ Id, Name, GroupType, Status }
Items[].Id / Name	string	Tidak	Identitas grup dan nama tampilan.	group-20260320141746-zsf6b / my-project-assets
Items[].GroupType / Status	string	Tidak	Jenis grup dan status saat ini.	AIGC / Active
PageNumber	integer	Tidak	Nomor halaman dikembalikan.	1
PageSize	integer	Tidak	Ukuran halaman yang dikembalikan.	10
TotalCount	integer	Tidak	Total grup yang cocok.	1

Contoh respons:

JSON

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

Kesalahan

Status	Artinya
400	Permintaan tidak valid.
401	Kunci API hilang atau tidak sah.

Contoh isi kesalahan (saat dikembalikan):

JSON

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

Pembuatan gambar, video, dan audio tidak sinkron. Setelah menerima ID aset, panggil GetAsset dan gunakan referensi asset://<ID> hanya ketika statusnya adalah Active.