Perbarui 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/UpdateAsset

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

Perbarui nama aset atau pindahkan ke grup lain.

Bidang	Ketik	Wajib diisi	Deskripsi	Contoh
Id	string	Ya	ID Aset.	asset-20260528140922-d9646
Name	string	Tidak	Nama aset baru.	updated-character-reference
GroupId	string	Tidak	ID grup tujuan.	group-20260320141746-zsf6b
model	string	Tidak	Model penagihan. Defaultnya adalah volc-asset.	volc-asset

Contoh JSON:

JSON

{
  "model": "volc-asset",
  "Id": "asset-20260528140922-d9646",
  "Name": "updated-character-reference",
  "GroupId": "group-20260320141746-zsf6b"
}

cURL contoh:

bash

curl --request POST https://modelflare.dev/volc/asset/UpdateAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "volc-asset",
  "Id": "asset-20260528140922-d9646",
  "Name": "updated-character-reference",
  "GroupId": "group-20260320141746-zsf6b"
}'

Tanggapan

Permintaan berhasil.

Bidang	Ketik	Wajib diisi	Deskripsi	Contoh
Id	string	Ya	ID Aset.	asset-20260528140922-d9646
Name	string	Tidak	Nama aset diperbarui.	updated-character-reference
GroupId	string	Tidak	ID grup aset.	group-20260320141746-zsf6b
UpdateTime	string	Tidak	Perbarui stempel waktu.	2026-05-28T06:09:31Z

Contoh respons:

JSON

{
  "Id": "asset-20260528140922-d9646",
  "Name": "updated-character-reference",
  "GroupId": "group-20260320141746-zsf6b",
  "UpdateTime": "2026-05-28T06:09:31Z"
}

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.