Buat aset audio

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 trek audio ke grup yang ada untuk alur kerja Seedance yang didukung.

Bidang	Ketik	Wajib diisi	Deskripsi	Contoh
GroupId	string	Ya	ID grup aset target.	group-20260320141746-zsf6b
AssetType	Audio	Ya	Harus Audio.	Audio
URL	string	Ya	URL Publik, URI data, atau Base64 mentah. WAV atau MP3 saja, 2–30 detik, tidak lebih dari 15 MB.	https://example.com/audio.mp3
file	binary	Tidak	Alternatif multi bagian untuk URL dengan batasan audio yang sama.	audio.mp3
Name	string	Tidak	Nama tampilan/pencarian, hingga 64 karakter.	background-music
model	string	Ya		volc-asset-audio
ProjectName	string	Tidak	Nama proyek. It must match the target group; defaultnya adalah default.	default

Contoh JSON:

JSON

{
  "model": "volc-asset-audio",
  "GroupId": "group-20260320141746-zsf6b",
  "Name": "background-music",
  "AssetType": "Audio",
  "URL": "https://example.com/audio.mp3",
  "ProjectName": "default"
}

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-audio" \
  --form "GroupId=group-20260320141746-zsf6b" \
  --form "file=@audio.mp3"

Tanggapan

Audio telah memasuki pemrosesan asinkron. Jajak pendapat GetAsset hingga Status menjadi Active atau Failed. Tidak ada SLA waktu unggah; file audio biasa membutuhkan waktu sekitar 3–6 detik, sedangkan antrean peninjauan yang sibuk dapat memakan 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.