Dapatkan 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/GetAsset

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

Membaca satu aset berdasarkan ID. Gunakan rute ini untuk melakukan polling unggahan asinkron hingga Status adalah Active atau Failed.

Bidang	Ketik	Wajib diisi	Deskripsi	Contoh
Id	string	Ya	ID Aset yang akan dikueri.	asset-20260528140922-d9646

Contoh JSON:

JSON

{
  "Id": "asset-20260528140922-d9646"
}

cURL contoh:

bash

curl --request POST https://modelflare.dev/volc/asset/GetAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "Id": "asset-20260528140922-d9646"
}'

Tanggapan

Permintaan berhasil.

Bidang	Ketik	Wajib diisi	Deskripsi	Contoh
Id	string	Ya	ID Aset.	asset-20260528140922-d9646
Name	string	Tidak	Nama aset.	character-reference
URL	string	Tidak	URL file sementara. Masa pakai yang didokumentasikan adalah 12 jam; jangan menyimpannya sebagai referensi generasi.	https://example.com/temporary-asset
AssetType	Image	Video	Audio	Tidak
GroupId	string	Tidak	Memiliki ID grup.	group-20260320141746-zsf6b
Status	Processing	Active	Failed	Tidak
ProjectName	string	Tidak	Nama proyek.	default
CreateTime / UpdateTime	string	Tidak	stempel waktu ISO 8601.	2026-05-28T06:09:31Z

Contoh respons:

JSON

{
  "Id": "asset-20260528140922-d9646",
  "Name": "character-reference",
  "AssetType": "Image",
  "GroupId": "group-20260320141746-zsf6b",
  "Status": "Active",
  "ProjectName": "default",
  "CreateTime": "2026-05-28T06:09:22Z",
  "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.