Buat aset gambar

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/CreateAsset

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

Tambahkan gambar ke grup yang ada. Setelah diproses, referensikan sebagai asset://<ID> dalam permintaan Seedance yang didukung.

Bidang	Ketik	Wajib diisi	Deskripsi	Contoh
GroupId	string	Ya	ID grup aset target.	group-20260320141746-zsf6b
AssetType	Image	Ya	Harus Image.	Image
URL	string	Ya	URL publik, URI data, atau Base64 mentah. Gambar harus lebih kecil dari 30 MB, 300–6000 piksel di setiap sisinya, dan memiliki rasio aspek 0,4–2,5.	https://example.com/image.jpg
file	binary	Tidak	Alternatif multi bagian untuk URL. JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, dan HEIF diterima.	image.jpg
Name	string	Tidak	Nama tampilan/pencarian, hingga 64 karakter. Itu tidak dikirim ke model.	character-reference
model	string	Tidak		volc-asset
ProjectName	string	Tidak	Nama proyek. It must match the target group; defaultnya adalah default.	default

Contoh JSON:

JSON

{
  "model": "volc-asset",
  "GroupId": "group-20260320141746-zsf6b",
  "Name": "character-reference",
  "AssetType": "Image",
  "URL": "https://example.com/image.jpg"
}

contoh multibagian/formulir-data:

bash

curl --request POST https://modelflare.dev/volc/asset/CreateAsset \
  --header "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --form "model=volc-asset" \
  --form "GroupId=group-20260320141746-zsf6b" \
  --form "file=@image.jpg"

Tanggapan

Gambar telah memasuki pemrosesan asinkron. Jajak pendapat GetAsset hingga Status menjadi Active atau Failed. Tidak ada SLA waktu unggah; gambar biasa memerlukan waktu sekitar 6–9 detik, sedangkan antrean peninjauan yang sibuk dapat memerlukan waktu sekitar 10 detik hingga 2 menit.

Bidang	Ketik	Wajib diisi	Deskripsi	Contoh
Id	string	Ya	ID Aset. Gunakan asset://<ID> hanya setelah statusnya Active.	asset-20260528140922-d9646

Contoh respons:

JSON

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

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.