Buat 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/CreateAssetGroup

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

Buat grup untuk aset gambar, video, dan audio yang digunakan oleh alur kerja Seedance.

Bidang	Ketik	Wajib diisi	Deskripsi	Contoh
Name	string	Ya	Nama grup aset.	my-project-assets
model	string	Tidak	Model penagihan. Defaultnya adalah volc-asset.	volc-asset

Contoh JSON:

JSON

{
  "Name": "my-project-assets",
  "model": "volc-asset"
}

cURL contoh:

bash

curl --request POST https://modelflare.dev/volc/asset/CreateAssetGroup \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "Name": "my-project-assets",
  "model": "volc-asset"
}'

Tanggapan

Grup telah dibuat.

Bidang	Ketik	Wajib diisi	Deskripsi	Contoh
Id	string	Ya	ID grup aset baru.	group-20260320141746-zsf6b

Contoh respons:

JSON

{
  "Id": "group-20260320120601-hsw4s"
}

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.