Daftar 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/ListAssets

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

Cantumkan aset dengan filter nama, grup, dan jenis grup opsional. Tunggu Status: Active sebelum menggunakan ID dalam permintaan Seedance.

Bidang	Ketik	Wajib diisi	Deskripsi	Contoh
model	string	Ya	Model penagihan. Defaultnya adalah volc-asset.	volc-asset
Filter.Name	string	Tidak	Filter nama aset kabur.	character
Filter.GroupIds	string[]	Tidak	Filter berdasarkan 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": "character",
    "GroupIds": [
      "group-20260320141746-zsf6b"
    ],
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 10
}

cURL contoh:

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

Tanggapan

Permintaan berhasil.

Bidang	Ketik	Wajib diisi	Deskripsi	Contoh
Items[]	object[]	Tidak	Objek aset dengan identitas, tipe, grup, status, proyek, dan stempel waktu.	{ Id, Name, AssetType, GroupId, Status, ... }
Items[].Id / Name	string	Tidak	Identitas aset dan nama tampilan.	asset-20260528140922-d9646 / character-reference
Items[].AssetType / GroupId	string	Tidak	Jenis aset dan grup pemilik.	Image / group-20260320141746-zsf6b
Items[].Status / ProjectName	string	Tidak	Processing state and project name.	Active / default
Items[].CreateTime / UpdateTime	string	Tidak	Stempel waktu pembuatan dan pembaruan ISO 8601.	2026-03-20T14:25:01Z
Items[].URL	string	Tidak	URL file sementara. Masa pakai yang didokumentasikan adalah 12 jam; gunakan asset://<ID> untuk permintaan pembuatan.	https://example.com/temporary-asset
Items[].Error	object	Tidak	Kesalahan pemrosesan dengan Code dan Message ketika Status adalah Failed.	{ Code, Message }
PageNumber	integer	Tidak	Nomor halaman dikembalikan.	1
PageSize	integer	Tidak	Ukuran halaman yang dikembalikan.	10
TotalCount	integer	Tidak	Total aset yang cocok.	2

Contoh respons:

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
}

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.