Buat aset video

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 video ke grup yang ada. ID yang dikembalikan dapat digunakan oleh alur kerja Seedance yang didukung setelah pemrosesan.

Bidang	Ketik	Wajib diisi	Deskripsi	Contoh
GroupId	string	Ya	ID grup aset target.	group-20260320141746-zsf6b
AssetType	Video	Ya	Harus Video.	Video
URL	string	Ya	URL video publik. Video Base64 tidak diterima. Gunakan MP4 atau MOV, 2–30 detik, 24–60 FPS, 300–6000 piksel di setiap sisi, rasio aspek 0,4–2,5, 480p/720p/1080p/4K, total piksel 407696–2086876, dan tidak lebih dari 200 MB.	https://example.com/video.mp4
file	binary	Tidak	Alternatif multibagian untuk URL dengan batasan video yang sama.	video.mp4
Name	string	Tidak	Nama tampilan/pencarian, hingga 64 karakter.	scene-clip
model	string	Ya		volc-asset-video
ProjectName	string	Tidak	Nama proyek. It must match the target group; defaultnya adalah default.	default

Contoh JSON:

JSON

{
  "model": "volc-asset-video",
  "GroupId": "group-20260320141746-zsf6b",
  "Name": "scene-clip",
  "AssetType": "Video",
  "URL": "https://example.com/video.mp4",
  "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-video" \
  --form "GroupId=group-20260320141746-zsf6b" \
  --form "file=@video.mp4"

Tanggapan

Video telah memasuki pemrosesan asinkron. Jajak pendapat GetAsset hingga Status menjadi Active atau Failed. Tidak ada SLA waktu unggah; video biasa membutuhkan waktu sekitar 9–12 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.